home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Die Speccy' 97
/
Die Speccy' 97.iso
/
amiga_system
/
the_aminet
/
util
/
rexx
/
tritonrexx376.lha
/
TritonRexx
/
tritonrexx.dok
< prev
next >
Wrap
Text File
|
1995-09-17
|
130KB
|
3,472 lines
##########################################################################
'tritonrexx.library' 37.6 (17.9.95)
Copyright (C) 1994,95 Jⁿrgen Kohrmeyer, <J_Kohrmeyer@wilam.north.de>
##########################################################################
Allgemeines
* ▄bersicht - Kurze Vorstellung der Library
* Copyright - Copyright und sonstige rechtliche Dinge
* History - Geschichtliche Entwicklung der Library
* Danksagungen - Ich m÷chte mich bedanken bei...
* Adresse des Autors - Wohin man Kommentare und Bugreports schickt
* Systemvoraussetzungen - 68040, 18MB Ram ;-)
* Installation - Installation der Library
* Triton-Info - Informationen ⁿber 'Triton'
Grundlagen
* triton.library - Gemeinsamkeiten mit der 'triton.library'
* Applikationen und Projekte - Die Grundlagen fⁿr ein Programm
* Taglisten verwenden - Wie Taglisten funktionieren
* OberflΣchen erstellen - Wie ein Fenster aufgebaut wird
* Tips und Probleml÷sungen - Was tun wenn...
* FlushTRX - Befehl zum Entfernen von Applikationen
Programmieren
* Applikationen - Eigenschaften von Applikationen
* Projekte/Fenster - Eigenschaften von Projekten/Fenstern
* Menⁿs - Eigenschaften von Menⁿs
* Objekte und Attribute - Menⁿs, Gadgets, Texte und Images
* Funktionen - Funktionen der Library
Sonstiges
* Index - Stichwortverzeichnis
▄bersicht
*********
Die 'tritonrexx.library' ist eine ARexx-Funktionslibrary. Sie enthΣlt
Funktionen zur Programmierung von BenutzeroberflΣchen mit ARexx, zur
Erstellung der OberflΣchen wird die 'triton.library' verwendet.
Siehe Triton-Info.
* Alle Features der 'triton.library V1.3' werden voll unterstⁿtzt
* Einfache Programmierung von Fenstern, Menⁿs, Gadgets und Requestern
* Datei-, und Fontrequester mit der 'asl.library'
* Einbindung von beliebigen Grafiken (Kickstart 3.0 erforderlich)
* Laden von Grafikdaten mit der 'datatypes.library'
Copyright und sonstige rechtliche Dinge
***************************************
Die 'tritonrexx.library' ist FREEWARE, das Copyright bleibt weiterhin beim
Autor Jⁿrgen Kohrmeyer. Das Archiv darf frei kopiert werden, solange es
unverΣndert weitergegeben, und nur eine geringe Kopiergebⁿhr erhoben wird.
Das unverΣnderte Archiv darf in Mailboxen zum Download angeboten werden, es
ist jedoch nicht erlaubt Geld dafⁿr zu verlangen oder dem Archiv Werbetexte
hinzuzufⁿgen. Das Archiv darf in Public-Domain Sammlungen aufgenommen
werden, es darf jedoch nicht auf Disketten vertrieben werden die mehr als 4,-
DM kosten! Der Vertrieb des Archivs auf 'CD-ROM' ist nur erlaubt, wenn der
Preis fⁿr eine CD 30,- DM nicht ⁿbersteigt!
Die Weitergabe der 'tritonrexx.library' zusammen mit anderen Programmen ist
nur gestattet, wenn es sich um 'PUBLIC DOMAIN' oder 'FREEWARE' handelt. Bei
allen anderen Arten von Software ist die Genehmigung des Autors unbedingt
erforderlich. In jedem Fall mu▀ bei der Ver÷ffentlichung ein Hinweis auf
die 'tritonrexx.library', den Autor und die Bezugsquelle fⁿr das
Komplettarchiv gegeben werden. Siehe Adresse des Autors.
Der Vertrieb der 'tritonrexx.library' zu kommerziellen Zwecken jeglicher Art
ist nur mit Genehmigung des Autors gestattet!
Der Autor gibt keine Garantie fⁿr die ZuverlΣssigkeit der im Archiv
enthaltenen Programme und Dateien! Sie benutzen die Dateien auf eigene
Gefahr! Der Autor kann nicht fⁿr irgendwelche SchΣden haftbar gemacht
werden, die durch die Anwendung der Programme oder Dateien entstehen!
'triton.library'
================
Zur Erstellung und Auswertung der OberflΣchen wird die 'triton.library'
verwendet, ein gro▀er Teil dieser Anleitung besteht aus der ▄bersetzung der
'Triton-Anleitung'!
Die 'triton.library' ist Copyright (C) by Stefan Zeiger.
Siehe Triton-Info.
ARexx-Skripte und sonstige Programme
====================================
Im Archiv befinden sich mehrere ARexx-Skripte und Programme:
* 'Break.rexx' ist Copyright (C) Nils Goers
* 'ChangeSTARTPRI.rexx' ist Copyright (C) Nils Goers
* 'Exchange.rexx' ist Copyright (C) Nils Goers
* 'ARexxControl' ist Copyright (C) Jⁿrgen Kohrmeyer
* 'HandleCX' ist Copyright (C) Martin Berndt
Entstehungsgeschichte
*********************
V37.1
Erste Alphaversion, Special-Herm-Edition ;-)
V37.2
Erste Betaversion
V37.6
Erste ver÷ffentlichte Version
Danksagungen
************
Mein Dank gilt:
*
Stefan Zeiger
fⁿr seine gro▀artige 'triton.library', ohne die
dieses Projekt nicht m÷glich gewesen wΣre.
*
Nils Goers
fⁿr seine ARexx-Skripte, die er extra fⁿr das Archiv
programmiert hat, fⁿr das Testen der Beta-Version und seine VorschlΣge
und Ideen.
*
Ralf Reiser
, der es auch als ARexx-Einsteiger geschafft hat
mit TritonRexx klarzukommen, fⁿr seine vielen Anregungen.
*
Hermann D÷rries
fⁿr sein hervorragendes Mailbox-System 'Wilam'
* Allen, die mir ihre Ideen mitgeteilt, oder Bugs gemeldet haben.
Adresse des Autors
******************
Der Autor ist unter folgenden Adressen erreichbar, bitte vorzugsweise die
E-Mail Adresse benutzen:
Postanschrift:
Jⁿrgen Kohrmeyer
Oststra▀e 2
49143 Bissendorf
Telefon:
+49-5402-5195
E-Mail:
j_kohrmeyer@wilam.north.de
Support-Mailbox:
WILAM Mailboxsystem Wildeshausen
Port 1 - +49-4431-92081 : USR DualStandard V.34
Port 2 - +49-4431-92082 : ZyXel 19.2k
Port 3 - +49-4431-92082 : ISDN X.75
Login mit Username MD, Download per Menⁿauswahl
Systemvoraussetzungen
*********************
* Die 'tritonrexx.library' ben÷tigt mindestens Kickstart/Workbench 2.04.
* Zur Einbindung von Grafiken wird mindestens Kickstart 3.0 ben÷tigt.
* Ein 68020+ Prozessor wird dringend empfohlen, die Library lΣuft aber
auch auf 68000er Systemen.
* Die 'triton.library', mindestens 'V1.3', wird unbedingt be÷tigt. Siehe
Triton-Info.
* Der ARexx-Interpreter
RexxMast
mu▀ gestartet sein.
Installation
************
Die Installation wird durch Doppelklick auf das 'Install'-Piktogramm
gestartet, es wird das Standard-Installationsprogramm 'Installer' verwendet.
Au▀erdem mu▀ die 'triton.library' installiert werden, dies wird nicht vom
oben beschriebenen Programm durchgefⁿhrt. Im Verzeichnis 'Triton' befindet
sich dazu ein Installationsprogramm.
Die Verwendung der Library setzt voraus, da▀ der ARexx-Interpreter zuvor
gestartet wurde. Das Programm, das den Arexx-Interpreter startet, befindet
sich in der Schublade
SYS:System
und hei▀t
RexxMast
. Falls dieses Programm
in Ihrem System nicht automatisch gestartet wird mⁿssen Sie es manuell
starten. Die einfachste Methode ist es aber, das Programm
RexxMast
in der
Batchdatei
S:User-Startup
aufzurufen. Dadurch wird ARexx bei jedem Start
des Rechners automatisch aufgerufen und im System installiert.
Zum Starten des ARexx-Interpreters fⁿgen Sie folgende Zeile in Ihre
S:User-Startup
ein:
SYS:System/RexxMast >NIL:
Informationen ⁿber 'Triton'
***************************
Im Verzeichnis
'Triton'
des TritonRexx-Archivs ist die AmigaOS 2.04+ Version
der 'triton.library' enthalten:
**********************************************
Triton
An object oriented GUI creation system.
Release 1.3
(c) 1993-1995 Stefan Zeiger
**********************************************
This is a minimum distribution version of Triton, the object oriented
graphical user interface creation system for AmigaOS. Not included in this
minimum distribution are:
- A Prefs editor for customizing Triton GUIs
- An optimized version of triton.library for OS3.0+
- Language catalogs
- Developer support material
If you want a full distribution, you may download Triton from the BBS of
'Tec Mania Systems':
>--------------------------------------<
Tec Mania Systems
SysOp: Bernd Hassenzahl
Phone: +49-6157-8742-7 (V34 28k8)
+49-6157-8742-8 (V32t 19k2)
+49-6157-91012-1 (ISDN X75)
+49-6157-91012-2 (ISDN X75)
>--------------------------------------<
Please log in as a guest and download Triton from the directory
'/T-M-S/BINAER/AMIGA/WIZARD-WORKS'.
The latest Triton user archive can also be obtained via FidoNet file
request as 'TRITON' from 'Publishers Treff BBS':
>--------------------------------------<
Publishers Treff
SysOp: Christoph Reichert
FidoNet: 2:244/6302.0
>--------------------------------------<
Contacting the author:
EMail: s.zeiger@laren.rhein-main.de
FidoNet: Stefan Zeiger 2:244/6302.15
Mail: Stefan Zeiger
SeligenstΣdter Weg 24
D-63796 Kahl
Germany
Voice: +49-6188-2684 (new!)
Please use EMail if possible. This is more convenient for me and your
chance of getting a reply quickly is much better.
Live long and prosper!
Gemeinsamkeiten mit der 'triton.library'
****************************************
Die 'triton.library' wird von fast allen Funktionen sehr intensiv genutzt.
Viele Funktionen konvertieren lediglich die Argumente, rufen danach die
entsprechende Triton-Funktion auf, und ⁿbermitteln die Rⁿckgabewerte an das
aufrufende ARexx-Skript.
SΣmtliche Angaben zur Programmierung, in der Dokumentation, den Autodocs und
dem C-Includefile 'libraries/triton.h', der 'triton.library' gelten auch fⁿr
die 'tritonrexx.library'. Alle Funktionen, Objekte, Attribute und Flags haben
die gleiche Bedeutung und sollten sich entsprechend dieser Dokumentation
verhalten.
Die Schreibweise der Funktionsnamen ist mit der 'triton.library' identisch,
mit dem Unterschied, da▀ nicht auf Gro▀- und Kleinschreibung geachtet wird.
Alle im C-Includefile 'libraries/triton.h' aufgefⁿhrten Makros sind in der
'tritonrexx.library' als Funktionen enthalten und k÷nnen wie gewohnt
verwendet werden. Auch hier wird nicht auf Gro▀- und Kleinschreibung
geachtet.
Die Schreibweise aller Attribute und Flags ist identisch mit den Definitionen
im C-Includefile 'libraries/triton.h' und den Beschreibungen in den Autodocs.
Hier wird ebenfalls nicht auf Gro▀- und Kleinschreibung geachtet.
Siehe Triton-Info.
Applikationen und Projekte
**************************
Applikationen
Die Applikation ist die Grundlage fⁿr alle Fenster, die mit den Funktionen
der 'tritonrexx.library' programmiert werden sollen. Jedes Skript mu▀ eine
solche Applikation erzeugen, bevor das erste Fenster ge÷ffnet werden kann.
Am Ende eines Skripts mu▀ jede erzeugte Applikation wieder gel÷scht werden,
damit der zugeh÷rige Speicher an das System zurⁿckgegeben wird.
Jeder Applikation mu▀ ein kurzer Name gegeben werden, der zur Identifikation
der Applikation dient.
Projekte
Jedes Projekt ist ein Ableger einer bestimmten Applikation. Es beinhaltet
genau ein Fenster, inclusive aller Eigenschaften, Menⁿs und Objekte. Jedem
Projekt sollte eine
einmalige
ID-Nummer zugewiesen werden, diese Nummer
wird von der 'triton.library' zum Speichern der Fensterposition und Gr÷▀e
verwendet.
Beim ╓ffnen eines Projekts mⁿssen die gewⁿnschten Eigenschaften des
Fensters, alle Menⁿs und darzustellenden Objekte mit ihren Eigenschaften
angegeben werden. Objekte sind z.B. Gadgets, Texte und Grafiken. Einige der
Fenster- und Objekteigenschaften lassen sich auch nachtrΣglich verΣndern.
Als erstes mⁿssen die Eigenschaften des Fensters angegeben werden, danach die
Menⁿs, und zum Schlu▀ die Objekte.
Taglisten verwenden
*******************
Die gesamte Definition aller Applikationen und Projekte erfolgt mit Hilfe von
sogenannten Taglisten. Eine Tagliste ist die Aneinanderreihung von
verschiedenen Attributen, die das Aussehen und Verhalten der beschriebenen
Applikation, eines Projekts oder Objekts bestimmen.
Jedes Attribut besteht immer aus einer Kennung und einer dazu geh÷renden
Datenangabe. Die einzelnen Attribute werden durch Leerzeichen oder Tabs
getrennt hintereinander geschrieben.
Die Datenangabe hat verschiedene Formate, je nach Art der ⁿbergebenen Daten:
============================================================================
Boolscher Wert
0 (falsch) oder 1 (wahr)
Integerzahl
Eine Zahl zwischen -2147483648 und 2147483647
Zeichenkette
Eine beliebige Zeichenkette, wenn darin Leerzeichen oder Tabulatoren
enthalten sind mu▀ die Zeichenkette in Anfⁿhrungszeichen gesetzt
werden.
Wenn die Zeichenkette in Anfⁿhrungszeichen gesetzt ist dient das
Zeichen '*' als Steuerzeichen. Der '*' wird dann nicht in die
Zeichenkette ⁿbernommen, sondern das nachfolgende Zeichen kann eine
bestimmte Bedeutung haben:
*E - ein Escape-Zeichen (ASCII 27)
*N - ein Zeilenvorschub (ASCII 10)
*" - ein Anfⁿhrungszeichen
** - ein '*'
Alle anderen Zeichen werden ohne ─ndrung ⁿbernommen, um den Text
"Hallo Welt" zu erhalten mⁿ▀te man also "*"Hallo Welt*"" schreiben.
Flags
Flags, die Eigenschaften eines Objekts angeben. Die Flags werden getrennt
durch '|' hintereinandergeschrieben. Diese Angabe darf keine Leerzeichen
enthalten.
Feld oder Liste von Zeichenketten
Der Name einer Stem-Variablen, in der die Zeichenketten enthalten sind.
Die Zeichenketten mⁿssen wie folgt gespeichert sein:
stemvar.0 - enthΣlt die Anzahl der Zeichenketten stemvar.1 - enthΣlt
die erste Zeichenkette stemvar.2 - enthΣlt die zweite Zeichenkette
stemvar.3 - enthΣlt die dritte Zeichenkette stemvar.n - enthΣlt die
n'te Zeichenkette
Zeiger
Dies betrifft Project-, Screen- und Window-Zeiger, die von anderen
Funktionen zurⁿckgegeben wurden. Die Rⁿckgabewerte enthalten dann eine
Zahl im binΣren Format, die so nicht als Datenangabe verwendet werden
kann. Ein solcher Zeiger mu▀ fⁿr die Angabe in einer Tagliste mit der
ARexx-Funktion C2D() in eine Zahl umgewandelt werden.
TextAttr-Struktur
Der Name einer Stem-Variablen, die die Elemente einer TextAttr-Struktur
enthΣlt. Die Variable mu▀ wie folgt aufgebaut sein:
stemvar.ta_name - EnthΣlt den Namen des Fonts, z.B. 'helvetica.font'
stemvar.ta_ysize - EnthΣlt die Gr÷▀e des Fonts
stemvar.ta_style - EnthΣlt eine Zahl, die den Stil des Fonts beschreibt:
0 - normal
1 - unterstrichen
2 - fett
3 - unterstrichen und fett
4 - kursiv
5 - unterstrichen und kursiv
6 - fett und kursiv
7 - unterstrichen, fett und kursiv
ta_style mu▀ nicht angegeben werden, Standard ist 0.
Image
Der logische Name einer Grafik, die zuvor mit 'CREATEIMAGE()' geladen
wurde.
TR_Dimensions-Struktur
Eine Stem-Variable, die die Elemente einer TR_Dimensions-Struktur
enthΣlt. Die Variable mu▀ wie folgt aufgebaut sein:
stemvar.trd_left - Die linke Ecke des Fensters
stemvar.trd_top - Die obere Ecke des Fensters
stemvar.trd_width - Die Breite des Fensters
stemvar.trd_height - Die H÷he des Fensters
stemvar.trd_left2 - Die alternative linke Ecke des Fensters
stemvar.trd_top2 - Die alternative obere Ecke des Fensters
stemvar.trd_width2 - Die alternative Breite des Fensters
stemvar.trd_height2 - Die alternative H÷he des Fensters
stemvar.trd_zoomed - Fenster gezoomt? - 0 oder 1
Ungenutzt
Die Datenangabe wird momentan nicht verwendet, mu▀ aber angegeben
werden. Am besten man gibt hier immer 0 an!
Den Abschlu▀ einer Tagliste bildet immer 'TAG_END' oder 'TAG_DONE', hier mu▀
keine Datenangabe mehr gemacht werden.
Beispiel fⁿr eine Tagliste:
===========================
apptags = 'TRCA_Name Wilko',
'TRCA_LongName Wilam-Mailboxverwaltung',
'TRCA_Info "Point-, Kosten- und Textverwaltung fⁿr Wilam"',
'TRCA_Version 3.0',
'TRCA_Release 1',
'TRCA_Date 24.7.95',
'TAG_END'
Bei diesem Beispiel dient das Komma am Ende jeder Zeile als
Fortsetzungszeichen, die Anweisung wird von ARexx wie eine Zeile behandelt.
OberflΣchen erstellen
*********************
Jedes Fenster wird in Gruppen aufgeteilt. Eine Gruppe ist ein Bereich in dem
sich verschiedene Objekte befinden. Dies k÷nnen auch wieder Gruppen sein,
die dann andere Objekte enthalten usw.
GrundsΣtzlich gibt es zwei Arten von Gruppen:
=============================================
Horizontale Gruppen - TRGR_Horiz
Die darin enthaltenen Objekte werden nebeneinander dargestellt. Die
zweite Dimension einer solchen Gruppe ist vertikal, dies dient zur
Ausrichtung der enthaltenen Objekte untereinander.
Vertikale Gruppen - TRGR_Vert
Die darin enthaltenen Objekte werden untereinander dargestellt. Die
zweite Dimension einer solchen Gruppe ist horizontal, dies dient
wiederum zur Ausrichtung der enthaltenen Objekte untereinander.
Einer Gruppe k÷nnen verschiedene Layout-Eigenschaften zugeordnet werden:
========================================================================
TRGR_PROPSHARE
Alle Objekte werden proportional zu ihrer minimalen Gr÷▀e skaliert.
Alle LeerrΣume bleiben dabei unverΣndert, das gleiche gilt auch fⁿr
alle nicht skalierbaren Objekte.
TRGR_EQUALSHARE
Alle Objekte haben in der primΣren Dimension die gleiche Gr÷▀e. Alle
Objekte sind mindestens so gro▀ wie das kleinste Objekt. Fⁿr LeerrΣume
und nicht skalierbare Objekte gilt das gleiche wie bei 'TRGR_PROPSHARE'.
TRGR_PROPSPACES
Alle Objekte, mit Ausnahme der LeerrΣume, behalten ihre minimale
Gr÷▀e. Die LeerrΣume werden proportional zu ihrer minimalen Gr÷▀e
skaliert.
TRGR_ARRAY
Eine solche Gruppe bildet die Obergruppe einer Tabelle von Objekten. Um
eine solche Tabelle anzulegen mu▀ eine Obergruppe mit der Eigenschaft
'TRGR_ARRAY' erzeugt werden, horizontal fⁿr eine spaltenorientierte,
vertikal fⁿr eine zeilenorientierte Tabelle. In der 'TRGR_ARRAY'-Gruppe
k÷nnen einzelne Objekte oder Untergruppen mit der entgegengesetzten
Richtung enthalten sein, diese Objekte werden dann tabellarisch innerhalb
der Gruppe angeordnet.
TRGR_INDEP
Untergruppen einer 'TRGR_ARRAY'-Gruppe, die das Attribut 'TRGR_INDEP'
besitzen, werden unabhΣngig von der Tabelle angeordnet, dies wird
hauptsΣchlich zum Einfⁿgen von Trennlinien verwendet.
Eigenschaften fⁿr die Ausrichtung der Objekte in der zweiten Dimension:
=======================================================================
TRGR_ALIGN
Alle in der zweiten Dimension der Gruppe skalierbaren Objekte werden auf
die volle Gr÷▀e der Gruppe skaliert.
TRGR_CENTER
Alle in der zweiten Dimension nicht skalierbaren Objekte werden
innerhalb der Gruppe zentriert.
Die Skalierbarkeit einer Gruppe kann auch abgeschaltet werden:
==============================================================
TRGR_FIXHORIZ
Die Gruppe behΣlt immer ihre minimale Breite.
TRGR_FIXVERT
Die Gruppe behΣlt immer ihre minimale H÷he.
Bei der Definition mu▀ jede Gruppe mit 'TRGR_Horiz' oder 'TRGR_Vert'
begonnen werden. Die Datenangabe enthΣlt die der Gruppe zugeordneten
Eigenschaften getrennt durch '|'. Den Abschlu▀ einer Gruppe bildet immer
'TRGR_End'. Die Datenangabe spielt dabei keine Rolle, mu▀ aber vorhanden
sein.
Tips und Probleml÷sungen
************************
* Tip: Einbinden der Library mit erh÷hter PrioritΣt
Die 'tritonrexx.library' sollte mit erh÷hter PrioritΣt eingebunden
werden, so da▀ sie von ARexx vor allen anderen Libraries nach
Funktionen durchsucht wird.
In Taglisten werden sehr hΣufig die fⁿr die einzelnen Objekte
angebotenen Makro-Funktionen verwendet, beim Interpretieren der
Taglisten mⁿssen dadurch sehr viele Funktionen aufgerufen werden. Die
erh÷hte PrioritΣt kann dabei eine erhebliche Steigerung der
Geschwindigkeit bewirken!
'tritonrexx.library' mit PrioritΣt 10 einbinden:
--------------------------------------------------------------------------
IF ~SHOW('LIBRARIES','tritonrexx.library') THEN DO
IF ~ADDLIB('tritonrexx.library',10,-30,0) THEN DO
SAY 'Kann die <tritonrexx.library> nicht ÷ffnen!'
EXIT(10)
END
END
* Beim Aufruf von Funktionen kommt es zu Fehlern, obwohl alle Argumente
richtig angegeben sind.
Dies liegt oft daran, da▀ andere Libraries mit gleichnamigen Funktionen
durch die ARexx-Funktion 'AddLib()' oder den DOS-Befehl 'RXLib' in die
Suchliste von ARexx eingebunden wurden. In diesem Fall ist es oft sehr
schwierig, weiterhin beide Libraries gleichzeitig zu verwenden. Um dieses
Problem zu l÷sen kann man erst einmal versuchen, durch unterschiedliche
PrioritΣten bei 'AddLib()' oder 'RXLib' die Suchreihenfolge von ARexx
entsprechend zu verΣndern. Falls dies nicht zum gewⁿnschten Ergebnis
fⁿhrt gibt es noch eine andere, eigentlich sogar bessere Methode. Alle
Funktionen der 'tritonrexx.library' k÷nnen auch ⁿber ein Alias
aufgerufen werden, indem man dem Funktionsnamen ein 'TRX_' voranstellt.
Fⁿr die Funktion 'TR_OpenProject()' wΣre der Aliasname z.B.
'TRX_TR_OpenProject()'.
* Nach dem Abbruch eines Skripts durch Fehler bleiben Fensterleichen
zurⁿck.
Wenn ein Skript mit einem Fehler abbricht, dann bleiben die in diesem
Skript bereits ge÷ffneten Fenster funktionsunfΣhig auf dem Bildschirm
zurⁿck, auch Grafiken k÷nnen sich noch im Speicher befinden. Zum
Schlie▀en solcher Fenster, Entfernen der zugeh÷rigen Applikation, und
L÷schen von ungenutzten Grafiken, dient der mitgelieferte DOS-Befehl
'FlushTRX'.
Siehe FlushTRX.
Ein fertig ausgetestetes Skript sollte auf jeden Fall die verschiedenen
Unterbrechungssignale von ARexx nutzen, um im Fehlerfall alle ge÷ffneten
Applikationen und Grafiken zu entfernen.
Beispiel:
--------------------------------------------------------------------------
/*
** Applikation beim Auftreten eines Unterbrechungssignals
** automatisch l÷schen und Skript ordnungsgemΣ▀ beenden.
*/
SIGNAL ON break_c
SIGNAL ON failure
SIGNAL ON halt
SIGNAL ON ioerr
SIGNAL ON syntax
app = TR_CREATEAPP('TRCA_Name Beispiel',
'TRCA_LongName "Beispiel fⁿr SIGNAL"',
'TRCA_Info "ARexx-Unterbrechungssignale nutzen"',
'TRCA_Version 1.0',
'TRCA_Release 1',
'TRCA_Date 30.7.95',
'TAG_END')
IF app ~= '00000000'x THEN DO
/*
** Hier steht das Skript
*/
CALL TR_DELETEAPP(app)
END
EXIT(0)
break_c:
failure:
halt:
ioerr:
syntax:
SAY '+++ Fehler' rc 'in Zeile' sigl '-' ERRORTEXT(rc)
SAY SOURCELINE(sigl)
IF app ~= '00000000'x THEN
CALL TR_DELETEAPP(app)
EXIT(10)
Der DOS-Befehl FlushTRX
***********************
Dieser Befehl dient zum Entfernen von Applikationen, die nach dem Abbruch
eines fehlerhaften Skripts nicht wieder gel÷scht wurden. Es k÷nnen immer
nur komplette Applikationen entfernt werden, das Schlie▀en von einzelnen
Fenstern ist nicht m÷glich! Ungenutzte Grafiken, die sich noch im Speicher
befinden, k÷nnen ebenfalls gel÷scht werden. 'FlushTRX' entfernt, wenn
m÷glich, auch die 'tritonrexx.library' aus dem Speicher.
Eine Applikation, auf die noch ein Skript zugreift, kann nicht entfernt
werden. Dies ist z.B. der Fall, wenn ein Skript gerade mit 'TR_Wait()' auf
Nachrichten von der Applikation wartet. Wenn ein Skript aber mit anderen
Dingen beschΣftigt ist, und die Applikation deshalb momentan nicht anspricht,
ⁿbernimmt 'FlushTRX' die Applikation und entfernt sie. Das Skript bricht
dann beim nΣchsten Zugriffsversuch auf die nicht mehr bestehende Applikation
mit dem Fehler 18 ab:
Command returned 10/18: Invalid argument to function
Grafiken k÷nnen nur gel÷scht werden, wenn sie nicht mehr in einem Fenster
dargestellt werden.
Au▀er dem Befehl 'FlushTRX' gibt es keine systemkonforme M÷glichkeit,
solche Applikationen nachtrΣglich zu entfernen! Grafiken k÷nnen auch
nachtrΣglich mit 'DeleteImage()' (Siehe DeleteImage().) gel÷scht werden.
Das Entfernen der 'tritonrexx.library' aus dem Speicher ist erst dann
m÷glich, wenn alle Applikationen und Grafiken gel÷scht sind.
Format
FlushTRX [[APPLICATION] <AppName>] [IMAGES] [ALL]
Schablone
FlushTRX APPLICATION,IMAGES/S,ALL/S
Argumente
APPLICATION - Der Name der zu entfernenden Applikation. Dies ist der
einmalige Name, der beim Erzeugen der Applikation unter
'TRCA_Name' angegeben wurde. Siehe Applikationen. Hier kann
auch ein AmigaDOS-Namensmuster angegeben werden,
FlushTRX #?
entfernt z.B. alle momentan nicht verwendeten Applikationen.
IMAGES - Wenn dieser Schalter angegeben ist, versucht das Programm
alle noch im Speicher befindlichen Grafiken zu l÷schen.
Die Anzahl der Grafiken, die gel÷scht werden konnten,
wird im Shell-Fenster ausgegeben.
ALL - Wenn dieser Schalter angegeben ist, versucht das Programm
alle noch im Speicher befindlichen Applikationen und
Grafiken zu l÷schen. Dies ist jedoch nur dann m÷glich,
wenn kein Skript mehr auf eine Applikation zugreift.
Eigenschaften von Applikationen
*******************************
ATTRIBUTE
Kennung Datenangabe Beschreibung
--------------------------------------------------------------------------
TRCA_Name Zeichenkette Ein einmaliger Name fⁿr die
Applikation, nicht lΣnger
als 20 Zeichen. Die Zeichen
' ', '/', '.' und ':' sind
nicht erlaubt.
TRCA_LongName Zeichenkette Ein Name fⁿr die Applikation,
der fⁿr Jeden sichtbar ist,
bis zu 60 Zeichen.
TRCA_Info Zeichenkette Kurze Information ⁿber die
Applikation, bis zu 2 Zeilen
mit je 60 Zeichen.
TRCA_Version Zeichenkette Die Interne Version der
Applikation.
TRCA_Release Zeichenkette Die Release-Version der
Applikation.
TRCA_Date Zeichenkette Das Erstellungsdatum der
Applikation, sollte im
Standard-Fromat fⁿr Datum
im Versions-String angegeben
werden.
FUNKTIONEN
Siehe TR_CreateApp().
DEFINITIONEN
-/-
Eigenschaften von Fenstern
**************************
ATTRIBUTE
Kennung Datenangabe Beschreibung
--------------------------------------------------------------------------
TRWI_Title Zeichenkette Fenstertitel (verΣnderbar)
TRWI_ScreenTitle Zeichenkette Bildschirmtitel bei aktivem
Fenster (verΣnderbar)
TRWI_Flags Flags
TRWF_BACKDROP Rahmenloses Hintergrundfenster
mit voller Bildschirmgr÷▀e
TRWF_NODRAGBAR Nicht verschiebbar
TRWF_NODEPTHGADGET Kann nich nach vorne oder
hinten bewegt werden
TRWF_NOCLOSEGADGET Ohne Schlie▀symbol
TRWF_NOACTIVATE Nicht aktiviert
TRWF_NOESCCLOSE Kann nicht mit ESC
geschlossen werden
TRWF_NOPSCRFALLBACK Nicht ÷ffnen wenn der
angegebene Bildschirm nicht
existiert
TRWF_NOZIPGADGET Kein Zoom-Symbol
TRWF_ZIPCENTERTOP Gezoomtes Fenster in der Mitte
der Titelzeile des Bildschirms
TRWF_NOMINTEXTWIDTH Fenstertitel bestimmt nicht
die Breite des Fensters
TRWF_NOSIZEGADGET Kein Gr÷▀enverΣnderungs-Symbol
TRWF_NOFONTFALLBACK Bei zu gro▀em Font nicht
topaz.font 8 verwenden
TRWF_NODELZIP Fenster bei DELETE
nicht zoomen
TRWF_ZIPTOCURRENTPOS Fensterposition bleibt beim
Zoomen gleich
TRWF_APPWINDOW Auf das Fenster kann man Icons
fallen lassen
TRWF_ACTIVATESTRGAD Das erste Texteingabefeld im
Fenster wird sofort aktiviert
TRWF_HELP Das Fenster sendet 'TRMS_HELP'
wenn ⁿber einem Menⁿ oder
Objekt HELP gedrⁿckt wird
TRWF_SYSTEMACTION Bei Diskettenwechsel sendet
das Fenster eine Nachricht:
'TRMS_DISKINSERTED'
'TRMS_DISKREMOVED'
TRWI_Underscore Zeichenkette Zeichen, mit dem die Hotkeys
markiert sind, Standard '_'
TRWI_Position Fensterposition
TRWP_DEFAULT La▀ dich ⁿberraschen ;-)
TRWP_BELOWTITLEBAR Links unter der Titelzeile
des Bildschirms
TRWP_CENTERTOP Zentriert, ganz oben auf
dem Bildschirm
TRWP_TOPLEFTSCREEN In der linken oberen Ecke
des Bildschirms
TRWP_CENTERSCREEN Zentriert auf dem Bildschirm
TRWP_CENTERDISPLAY Zentriert im dargestellten
Bildschirmausschnitt
TRWP_MOUSEPOINTER Zentriert unter dem Mauszeiger
TRWI_CustomScreen Zeiger Eigener Bilschirm, auf dem
das Fenster ge÷ffnet werden
soll
TRWI_PubScreen Zeiger ╓ffentlicher Bildschirm,
auf dem das Fenster ge÷ffnet
werden soll
TRWI_PubScreenName Zeichenkette Namen eines ÷ffentlichen
Bildschirms, auf dem das
Fenster ge÷ffnet wereden
soll
TRWI_PropFontAttr TextAttr Stem-Variable, die eine
TextAttr-Struktur fⁿr den
Proportional-Font des
Fensters enthΣlt
Siehe Taglisten verwenden.
TRWI_FixedWidthFontAttr TextAttr Stem-Variable, die eine
TextAttr-Struktur fⁿr den
Font mit fester Breite des
Fensters enthΣlt
Siehe Taglisten verwenden.
TRWI_Backfill Fⁿllmuster Siehe Fⁿllmuster fⁿr Fenster.
TRWI_ID Integer ID-Nummer des Fensters,
gleichartige Fenster sollten
gleiche Nummern haben, sonst
immer verschiedene
TRWI_Dimensions Dimensionen Stem-Variable, die eine
TR_Dimensions-Struktur enthΣlt.
Nach dem Schlie▀en des Fensters
enthalten die Felder der hier
angegebenen Variablen die letzte
Position und Gr÷▀e des Fensters.
Siehe Taglisten verwenden.
TRWI_QuickHelp Bool QuickHelp ein/ausschalten
FUNKTIONEN
WindowTitle(title)
Fenstertitel angeben
ScreenTitle(title)
Bildschirmtitel angeben
WindowID(id)
ID-Nummer angeben
WindowFlags(flags)
Flags angeben
WindowPosition(position)
Fensterposition angeben
WindowUnderscore(underscore)
Zeichen angeben, mit dem die Hotkeys markiert sind
WindowDimensions(TR_Dimensions)
Fensterdimensionen angeben
CustomScreen(screen)
Zeiger auf einen eigenen Bildschirm
PubScreen(screen)
Zeiger auf einen ╓ffentlichen Bildschirm
PubScreenName(screenname)
Name eines ÷ffentlichen Bildschirms
QuickHelpOn(bool)
QuickHelp ein/ausschalten
BeginRequester(title,position)
Markiert den Beginn eines Fensters, das mit dem Aussehen eines
Requesters ge÷ffnet werden soll
DEFINITIONEN
EndProject
Markiert das Ende einer Projekt-Tagliste
BeginRequesterGads
Markiert den Beginn der Gadgets im unteren Teil eines Requesters
EndRequester
Markiert das Ende eines Requesters
Siehe Fⁿllmuster fⁿr Fenster.
Menⁿs anlegen
*************
ATTRIBUTE
Kennung Datenangabe Beschreibung
--------------------------------------------------------------------------
TRMN_Title Zeichenkette Menⁿtitel
TRMN_Item Zeichenkette Ein Menⁿpunkt in dem zuvor
angegebenen Menⁿ. Eine Taste
kann angegeben werden indem
man das gewⁿnschte Zeichen
dem Text voranstellt, gefolgt
von '_' und schlie▀lich dem
Text. Steuertasten k÷nnen
genauso angegeben werden,
jedoch mu▀ das erste Zeichen
ein '_' sein.
S_Datei speichern
D_Drucken
_F1_Text anzeigen
_Delete_L÷schen
Wenn als Text 'TRMN_BARLABEL'
angegeben wird, dann ist der
Menⁿpunkt eine Trennlinie.
TRMN_Sub Zeichenkette Ein Untermenⁿpunkt zu dem
zuvor angegebenen Menⁿpunkt.
Hier gilt das gleiche wie bei
'TRMN_Item'.
TRMN_Flags Flags
TRMF_CHECKIT Ein Menⁿpunkt zum abhaken
TRMF_CHECKED Der Menⁿpunkt ist abgehakt
TRMF_DISABLED Nicht anwΣhlbar
TRAT_ID Integer ID-Nummer eines Menⁿpunkts
FUNKTIONEN
BeginMenu(title)
Beginn eines neuen Menⁿs
MenuFlags(flags)
Menⁿ-Flags angeben
MenuItem(text,id)
Ein normaler Menⁿpunkt
MenuItemC(text,id)
Ein Menⁿpunkt zum abhaken
MenuItemCC(text,id)
Ein abgehakter Menⁿpunkt
MenuItemD(text,id)
Ein normaler Menⁿpunkt, nicht anwΣhlbar
BeginSub(title)
Beginn eines Untermenⁿs
SubItem(text,id)
Ein Untermenⁿpunkt
SubItemD(text,id)
Ein Untermenⁿpunkt, nicht anwΣhlbar
DEFINITIONEN
ItemBarlabel
Eine Trennline im Menⁿ
SubBarlabel
Eine Trennline im Untermenⁿ
Objekte und Attribute
*********************
Alle Bestandteile eines Fensters nennt man Objekte. Folgende Liste enthΣlt
alle verfⁿgbaren Objekte mit den dazu geh÷renden Eigenschaften:
Objekte, die Aktionen ausl÷sen
* Button - Einfache Kn÷pfe
* CheckBox - Ein/Aus Schalter
* Cycle - Felder zur Mehrfachauswahl
* DropBox - FlΣchen zum Fallenlassen von Icons
* Listview - Listen zur Darstellung und Auswahl
* Palette - Auswahl von Farben
* Scroller - Schieberegler zum Scrollen durch Listen
* Slider - Schieberegler zur Einstellung von Werten
* String - Texteingabefelder
Grafische Objekte
* FrameBox - Einrahmen von Gruppen
* Group - Gruppen
* Image - Grafiken
* Line - Trennlinien
* Progress - Fortschritt von Arbeiten anzeigen
* Space - LeerrΣume zwischen Objekten
* Text - Texte in verschiedenen Darstellungsarten
Sonstiges
* QuickHelp - Kurzhilfe
* Fⁿllmuster fⁿr Fenster - Fensterhintergrund fⁿllen
* Fⁿllmuster fⁿr Objekte - Objekthintergrund fⁿllen
Button
******
OBJEKTNAME
TROB_Button
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Button Typ
TRBT_TEXT Einfacher Knopf mit Text
TRBT_GETFILE Datei-Request-Knopf
TRBT_GETDRAWER Verzeichnis-Rquest-Knopf
TRBT_GETENTRY Listen-Auswahl-Knopf
TRAT_Disabled Bool Knopf anwΣhlbar?
TRAT_Flags Flags
TRBU_RETURNOK Anwahl auch mit RETURN
TRBU_ESCOK Anwahl auch mit ESC
TRBU_SHIFTED Tastatur nur mit SHIFT
TRBU_UNSHIFTED Tastatur nur ohne SHIFT
TRBU_YRESIZE Vertikal skalierbar
TRAT_ID Integer ID-Nummer des Knopfs
TRAT_Text Zeichenkette Text fⁿr den Knopf
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
Button(text,id)
Einfacher Knopf
ButtonR(text,id)
Einfacher Knopf, kann mit RETURN angewΣhlt werden
ButtonE(text,id)
Einfacher Knopf, kann mit ESC angewΣhlt werden
ButtonRE(text,id)
Einfacher Knopf, kann mit RETURN und ESC angewΣhlt werden
CenteredButton(text,id)
Wie 'Button()', nur zentriert
CenteredButtonR(text,id)
Wie 'ButtonR()', nur zentriert
CenteredButtonE(text,id)
Wie 'ButtonE()', nur zentriert
CenteredButtonRE(text,id)
Wie 'ButtonRE()', nur zentriert
EmptyButton(id)
Ein Knopf ohne Text
GetFileButton(id)
Ein Datei-Request-Knopf
GetDrawerButton(id)
Ein Verzeichnis-Request-Knopf
GetEntryButton(id)
Ein Listen-Auswahl-Knopf
GetFileButtonS(s,id)
Wie 'GetFileButton()', nur mit Text
GetDrawerButtonS(s,id)
Wie 'GetDrawerButton()', nur mit Text
GetEntryButtonS(s,id)
Wie 'GetEntryButton()', nur mit Text
DEFINITIONEN
-/-
CheckBox
********
OBJEKTNAME
TROB_CheckBox
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_CheckBox Ungenutzt
TRAT_Disabled Bool Schalter anwΣhlbar?
TRAT_ID Integer ID-Nummer des Schalters
TRAT_Value Bool Eingeschaltet?
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
CheckBox(id)
Einfacher Schalter, abgeschaltet
CheckBoxC(id)
Einfacher Schalter, eingeschaltet
CheckBoxLEFT(id)
Wie 'CheckBox()', nur linksbⁿndig
CheckBoxCLEFT(id)
Wie 'CheckBoxC()', nur linksbⁿndig
DEFINITIONEN
-/-
Cycle
*****
OBJEKTNAME
TROB_Cycle
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Cycle EintrΣge Stem-Variable, die die
anwΣhlbaren EintrΣge enthΣlt
TRAT_Disabled Bool Auswahlfeld anwΣhlbar?
(Radio-Buttons nur ab OS3.0)
TRAT_Flags Flags
TRCY_MX Darstellung als Radio-Buttons
TRCY_RIGHTLABELS Texte rechts von den Kn÷pfen
TRAT_ID Integer ID-Nummer des Auswahlfeldes
TRAT_Value Integer Nummer des angewΣhlten
Eintrags
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
CycleGadget(eintrΣge,value,id)
Einfaches Auswahlfeld
MXGadget(eintrΣge,value,id)
Auswahlfeld als Radio-Buttons
MXGadgetR(eintrΣge,value,id)
Wie 'MXGadget()', Texte rechts von den Kn÷pfen
DEFINITIONEN
-/-
DropBox
*******
OBJEKTNAME
TROB_DropBox
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_DropBox Ungenutzt
TRAT_Disabled Bool Dorpbox benutzbar?
TRAT_ID Integer ID-Nummer der Dropbox
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
DropBox(id)
Einfache Dropbox
DEFINITIONEN
-/-
Listview
********
OBJEKTNAME
TROB_Listview
ATTRIBUTE
Kennung Datenangabe Beschreibung
-----------------------------------------------------------------------
TROB_Listview EintrΣge Stem-Variable, die die
EintrΣge der Liste enthΣlt
TRAT_Disabled Bool Listview aktiv?
TRAT_Flags Flags
Typ, diese Flags schlie▀en sich gegenseitig aus
------------------------------------------------
TRLV_READONLY Liste ist nur lesbar
TRLV_SELECT Auswahl m÷glich
TRLV_SHOWSELECTED AusgewΣhlter Eintrag wird
markiert
Sonstige Flags
------------------------------------------------
TRLV_NOCURSORKEYS Cursortasten nicht verwenden
TRLV_NONUMPADKEYS Zehnerblock nicht verwenden
TRLV_FWFONT Zeichensatz mit fester Breite
TRLV_NOGAP Kein Leerraum unter der Liste,
stattdessen am Ende der Gruppe
TRAT_ID Integer ID-Nummer des Listviews
TRAT_MinWidth Integer Minimale Breite in Zeichen
(Standard sind 10 Zeichen)
TRAT_MinHeight Integer Minimale H÷he in Zeilen
(Standard sind 4 Zeilen)
TRAT_Value Integer Nummer des ausgewΣhlten Eintrags
der erste Eintrag ist 0!!!
TRLV_Top Integer Nummer des obersten Eintrags
in der Anzeige
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
ListRO(eintrΣge,id,top)
Einfache Liste, nur lesbar
ListSel(eintrΣge,id,top)
Einfache Liste, EintrΣge auswΣhlbar
ListSS(eintrΣge,id,top,value)
Einfache Liste, ausgewΣhlter Eintrag wird markiert
ListROC(eintrΣge,id,top)
Wie 'ListRO()', keine Steuerung mit den Cursortasten
ListSelC(eintrΣge,id,top)
Wie 'ListSel()', keine Steuerung mit den Cursortasten
ListSSC(eintrΣge,id,top,value)
Wie 'ListSS()', keine Steuerung mit den Cursortasten
ListRON(eintrΣge,id,top)
Wie 'ListRO()', keine Steuerung mit dem Zehnerblock
ListSelN(eintrΣge,id,top)
Wie 'ListSel()', keine Steuerung mit dem Zehnerblock
ListSSN(eintrΣge,id,top,value)
Wie 'ListSS()', keine Steuerung mit dem Zehnerblock
ListROCN(eintrΣge,id,top)
Wie 'ListRO()', keine Steuerung mit den Cursortasten und dem
Zehnerblock
ListSelCN(eintrΣge,id,top)
Wie 'ListSel()', keine Steuerung mit den Cursortasten und dem
Zehnerblock
ListSSCN(eintrΣge,id,top,value)
Wie 'ListSS()', keine Steuerung mit den Cursortasten und dem
Zehnerblock
---------------------------------------------------------------------
FWListRO(eintrΣge,id,top)
Wie 'ListRO()', Zeichensatz mit fester Breite
FWListSel(eintrΣge,id,top)
Wie 'ListSel()', Zeichensatz mit fester Breite
FWListSS(eintrΣge,id,top,value)
Wie 'ListSS()', Zeichensatz mit fester Breite
FWListROC(eintrΣge,id,top)
Wie 'ListROC()', Zeichensatz mit fester Breite
FWListSelC(eintrΣge,id,top)
Wie 'ListSelC()', Zeichensatz mit fester Breite
FWListSSC(eintrΣge,id,top,value)
Wie 'ListSSC()', Zeichensatz mit fester Breite
FWListRON(eintrΣge,id,top)
Wie 'ListRON()', Zeichensatz mit fester Breite
FWListSelN(eintrΣge,id,top)
Wie 'ListSelN()', Zeichensatz mit fester Breite
FWListSSN(eintrΣge,id,top,value)
Wie 'ListSSN()', Zeichensatz mit fester Breite
FWListROCN(eintrΣge,id,top)
Wie 'ListROCN()', Zeichensatz mit fester Breite
FWListSelCN(eintrΣge,id,top)
Wie 'ListSelCN()', Zeichensatz mit fester Breite
FWListSSCN(eintrΣge,id,top,value)
Wie 'ListSSCN()', Zeichensatz mit fester Breite
DEFINITIONEN
-/-
Palette
*******
OBJEKTNAME
TROB_Palette
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Palette Ungenutzt
TRAT_Disabled Bool Palette anwΣhlbar?
TRAT_ID Integer ID-Nummer der Palette
TRAT_Value Integer Nummer der ausgewΣhlten
Farbe
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
PaletteGadget(value,id)
Einfache Palette zur Farbauswahl
DEFINITIONEN
-/-
Scroller
********
OBJEKTNAME
TROB_Scroller
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Scroller Flags
TROF_HORIZ Horizontaler Scroller
TROF_VERT Vertikaler Scroller
TRAT_Disabled Bool Scroller anwΣhlbar?
TRAT_ID Integer ID-Nummer des Scrollers
TRAT_Value Integer Nummer des ersten sichtbaren
Eintrags der Liste, die der
Scroller steuert
TRSC_Total Integer Gesamtanzahl der EintrΣge der
Liste, die der Scroller steuert
TRSC_Visible Integer Anzahl der sichtbaren EintrΣge
der Liste, die der Regler steuert
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
-/-
DEFINITIONEN
-/-
Slider
******
OBJEKTNAME
TROB_Slider
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Slider Flags
TROF_HORIZ Horizontaler Schieberegler
TROF_VERT Vertikaler Schieberegler
TRAT_Disabled Bool Schieberegler anwΣhlbar?
TRAT_ID Integer ID-Nummer des Schiebereglers
TRAT_Value Integer Anzuzeigender Wert
TRSL_Min Integer Kleinster einstellbarer Wert
TRSL_Max Integer Gr÷▀ter einstellbarer Wert
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
SliderGadget(minimum,maximum,value,id)
Einfacher, horizontaler Schieberegler
DEFINITIONEN
-/-
WICHTIG
Mit Slider-Gadgets k÷nnen in der aktuellen Version keine negativen
Zahlen eingestellt werden. Falls sich die Verwendung von negativen
Zahlen nicht vermeiden lΣ▀t kann man sich mit einem Trick behelfen.
Man wΣhlt einen Einstellbereich von '0 bis Maximalwert-Minimalwert',
der angezeigte Wert errechnet sich dann aus 'SliderValue+Minimalwert'.
Beispiel:
---------
minimum = -128
maximum = 127
wert = -100
Slider erstellen:
-----------------
SliderGadget(0,maximum-minimum,wert+minimum,1)
Anzuzeigenden Wert ermitteln:
-----------------------------
wert = TR_GETATTRIBUTE(project,1,'TRAT_Value')+minimum
Wert aus einer 'TRMS_NEWVALUE-Nachricht' auslesen:
--------------------------------------------------
wert = stemvar.trm_data+minimum
String
******
OBJEKTNAME
TROB_String
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_String Zeichenkette Der zu edierende Text
TRAT_Disabled Bool Eingabefeld aktivierbar?
TRAT_Flags Flags
TRST_INVISIBLE Die Eingabe ist nicht
sichtbar (Passwort)
TRST_NORETURNBROADCAST RETURN-Meldung nicht
weiterreichen
TRAT_ID Integer ID-Nummer des Eingabefeldes
TRAT_Value Integer Maximale Anzahl Zeichen
TRDO_QuickHelpString Zeichenkette Kurzer Hilfstext
FUNKTIONEN
StringGadget(defaultstring,id)
Ein normales Texteingabefeld
PasswordGadget(defaultstring,id)
Ein Eingabefeld fⁿr Passw÷rter
DEFINITIONEN
-/-
FrameBox
********
OBJEKTNAME
TROB_FrameBox
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_FrameBox Typ
TRFB_TEXT Rahmen fⁿr eine Textbox
TRFB_GROUPING Ein Gruppen-Rahmen
TRFB_FRAMING Einrahmung einer Gruppe
TRAT_Backfill Fⁿllmuster Siehe Fⁿllmuster fⁿr Objekte.
TRAT_ID Integer ID-Nummer des Rahmens
TRAT_Text Zeichenkette Text fⁿr den Rahmen
Es wird nur das nachfolgende Objekt eingerahmt. Wenn eine ganze Gruppe
eingerahmt werden soll mu▀ also das erste Objekt nach der FrameBox die
einzurahmende Gruppe sein. Siehe Group.
FUNKTIONEN
NamedFrameBox(text)
Einrahmung einer Gruppe mit Text als ▄berschrift
TextBox(text,id,minwidth)
Eine Textbox mit mindestens 'minwidth' Zeichen Breite
DEFINITIONEN
GroupBox
Einfacher Gruppenrahmen
Group
*****
OBJEKTNAME
TRGR_Horiz TRGR_Vert
ATTRIBUTE
Kennung Datenangabe Beschreibung
--------------------------------------------------------------------------
TRGR_Horiz Flags Siehe OberflΣchen erstellen.
TRGR_Vert Flags Siehe OberflΣchen erstellen.
TRGR_PROPSHARE Objekte proportional anordnen
TRGR_EQUALSHARE Objekte gleichmΣ▀ig anordnen
TRGR_PROPSPACES LeerrΣume skalieren
TRGR_ARRAY Tabelle von Objekten
TRGR_ALIGN Objekte aneinander anpassen
TRGR_CENTER Objekte zueinander zentrieren
TRGR_FIXHORIZ Gruppe mit fester Breite
TRGR_FIXVERT Gruppe mit fester H÷he
TRGR_INDEP Gruppe ist von der ⁿbergeordneten
Tabelle unabhΣngig
TRAT_ID Integer ID-Nummer der Gruppe
TRGR_End Ungenutzt Markiert das Ende einer Gruppe
FUNKTIONEN
-/-
DEFINITIONEN
HorizGroup
Einfache horizontale Gruppe
HorizGroupE
Horizontale Gruppe, alle Objekte haben die gleiche Breite
HorizGroupS
Horizontale Gruppe, alle Objekte haben die minimale Breite,
LeerrΣume werden skaliert
HorizGroupA
Horizontale Gruppe, alle Objekte haben die gleiche H÷he
HorizGroupC
Horizontale Gruppe, alle Objekte werden vertikal zentriert
angeordnet
HorizGroupEA
Kombination aus 'HorizGroupE' und 'HorizGroupA'
HorizGroupSA
Kombination aus 'HorizGroupS' und 'HorizGroupA'
HorizGroupEC
Kombination aus 'HorizGroupE' und 'HorizGroupC'
HorizGroupSC
Kombination aus 'HorizGroupS' und 'HorizGroupC'
HorizGroupAC
Kombination aus 'HorizGroupA' und 'HorizGroupC'
HorizGroupEAC
Kombination aus 'HorizGroupE', 'HorizGroupA' und 'HorizGroupC'
HorizGroupSAC
Kombination aus 'HorizGroupS', 'HorizGroupA' und 'HorizGroupC'
---------------------------------------------------------------------
VertGroup
Einfache vertikale Gruppe
VertGroupE
Vertikale Gruppe, alle Objekte haben die gleiche H÷he
VertGroupS
Vertikale Gruppe, alle Objekte haben die minimale H÷he, LeerrΣume
werden skaliert
VertGroupA
Vertikale Gruppe, alle Objekte haben die gleiche Breite
VertGroupC
Vertikale Gruppe, alle Objekte werden horizontal zentriert
angeordnet
VertGroupEA
Kombination aus 'VertGroupE' und 'VertGroupA'
VertGroupSA
Kombination aus 'VertGroupS' und 'VertGroupA'
VertGroupEC
Kombination aus 'VertGroupE' und 'VertGroupC'
VertGroupSC
Kombination aus 'VertGroupS' und 'VertGroupC'
VertGroupAC
Kombination aus 'VertGroupA' und 'VertGroupC'
VertGroupEAC
Kombination aus 'VertGroupE', 'VertGroupA' und 'VertGroupC'
VertGroupSAC
Kombination aus 'VertGroupS', 'VertGroupA' und 'VertGroupC'
---------------------------------------------------------------------
EndGroup
Ende einer Gruppe
ColumnArray
Anfang einer Spalten-Tabelle
LineArray
Anfang einer Zeilen-Tabelle
BeginColumn
Anfang einer neuen Spalte innerhalb der Tabelle
BeginLine
Anfang einer neuen Zeile innerhalb der Tabelle
BeginColumnI
Anfang einer unabhΣngigen Spalte innerhalb der Tabelle
BeginLineI
Anfang einer unabhΣngigen Zeile innerhalb der Tabelle
EndColumn
Ende einer Spalte innerhalb der Tabelle
EndLine
Ende einer Zeile innerhalb der Tabelle
EndArray
Ende einer Tabelle
Image
*****
OBJEKTNAME
TROB_Image
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Image Image Der logische Name einer
zuvor angelegten Grafik
Siehe CreateImage().
TRAT_Flags Flags
TRIM_BOOPSI
In der aktuellen Version mu▀
dieses Flag immer angegeben
werden, sonst kann es zu
Abstⁿrzen kommen!
TRAT_MinWidth Integer Minimale Breite der Grafik
in Pixel (Standard ist die
H÷he eines Knopfes)
TRAT_MinHeight Integer Minimale H÷he der Grafik
in Pixel (Standard ist die
H÷he eines Knopfes)
TRAT_ID Integer ID-Nummer der Grafik
FUNKTIONEN
BoopsiImage(image)
Einfache Grafik
BoopsiImageD(image,minwidth,minheight)
Einfache Grafik, jedoch mit minimaler Breite und H÷he
DEFINITIONEN
-/-
Line
****
OBJEKTNAME
TROB_Line
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Line Flags
TROF_HORIZ Horizontale linie
TROF_VERT Vertikale linie
TROF_RAISED Linie ist erhaben
FUNKTIONEN
Line(flags)
Einfache Linie
NamedSeparator(text)
Horizontale Trennlinie mit Leerraum an Anfang und Ende und Text in
der Mitte
NamedSeparatorI(te,id)
WIe 'NamedSeparator()', nur mit ID-Nummer
NamedSeparatorN(text)
Horizontale Trennlinie mit Text in der Mitte
NamedSeparatorIN(te,id)
WIe 'NamedSeparatorN()', nur mit ID-Nummer
DEFINITIONEN
HorizSeparator
Horizontale Trennlinie mit Leerraum an Anfang und Ende
VertSeparator
Vertikale Trennlinie mit Leerraum oben und unten
Progress
********
OBJEKTNAME
TROB_Progress
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Progress Integer Maximaler Wert,
z.B. 100 bei Prozentanzeige
TRAT_Flags Flags
TROF_HORIZ Horizontal (Standard)
TROF_VERT Vertikal
TRAT_ID Integer ID-Nummer
TRAT_Value Integer Anzuzeigender Wert
FUNKTIONEN
Progress(maximum,value,id)
Horizontale Fortschrittsanzeige
DEFINITIONEN
-/-
Space
*****
OBJEKTNAME
TROB_Space
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Space Typ
TRST_NONE Kein Leerraum
TRST_SMALL Kleiner Leerraum
TRST_NORMAL Normaler Leerraum
TRST_BIG Gro▀er Leerraum
FUNKTIONEN
-/-
DEFINITIONEN
SpaceB
Gro▀er Leerraum
Space
Normaler Leerraum
SpaceS
Kleiner Leerraum
SpaceN
Kein Leerraum
Text
****
OBJEKTNAME
TROB_Text
ATTRIBUTE
Kennung Datenangabe Beschreibung
---------------------------------------------------------------------
TROB_Text Ungenutzt
TRAT_ID Integer ID-Nummer des Textes
Wenn ein anderes Objekt die gleiche ID besitzt,
und im Text einem Zeichen ein '_' vorangestellt
ist, dann kann das zugeh÷rige Objekt mit der
entsprechenden Taste gesteuert werden.
TRAT_Flags Flags
TRTX_NOUNDERSCORE '_' wird nicht beachtet
TRTX_HIGHLIGHT Hervorgehobener Text
TRTX_3D Text mit Schatten
TRTX_BOLD Fett geschriebener Text
TRTX_TITLE Titeltext, Attribute wie mit
'Prefs/Triton' eingestellt
TROF_RIGHTALIGN Text ist rechtsbⁿndig
TRTX_CLIPPED Im zugeh÷rigen Bereich nicht
mehr darstellbarer Text wird
abgeschnitten
TRAT_MinWidth Integer Minimale Breite des Textes
in Zeichen
TRAT_Text Zeichenkette Der anzuzeigende Text
TRAT_Value Integer Eine anzuzeigende Zahl
FUNKTIONEN
TextN(text)
Normaler Text
TextH(text)
Hervorgehobener Text
Text3(text)
Text mit Schatten
TextB(text)
Fett geschriebener Text
TextT(text)
Titeltext, Attribute wie mit 'Prefs/Triton' eingestellt
TextID(text,id)
Normaler Text mit ID
TextNR(text)
Normaler, rechtsbⁿndiger Text
TextRIGHT(text,id)
Rechtsbⁿndiger Text mit ID
ClippedText(text)
Normaler Text, zu langer Text wird abgeschnitten
ClippedTextID(text,id)
Normaler Text mit ID, zu langer Text wird abgeschnitten
CenteredText(text)
Zentrierter Text
CenteredTextH(text)
Zentrierter, hervorgehobener Text
CenteredText3(text)
Zentrierter Text mit Schatten
CenteredTextB(text)
Zentrierter, fett geschriebener Text
CenteredTextID(text,id)
Zentrierter Text mit ID
CenteredText_BS(text)
Zentrierter Text mit gro▀em Leerraum an Anfang und Ende
---------------------------------------------------------------------
Integer(integer)
Normale Integerzahl
IntegerH(integer)
Hervorgehobene Integerzahl
Integer3(integer)
Integerzahl mit Schatten
IntegerB(integer)
Fett geschriebene Integerzahl
CenteredInteger(integer)
Zentrierte Integerzahl
CenteredIntegerH(integer)
Zentrierte, hervorgehobene Integerzahl
CenteredInteger3(integer)
Zentrierte Integerzahl mit Schatten
CenteredIntegerB(integer)
Zentrierte, fett geschriebene Integerzahl
---------------------------------------------------------------------
TextBox(text,id,mwid)
Ein Text-Anzeigefeld
ClippedTextBox(text,id)
Wie 'TextBox()', zu langer Text wird abgeschnitten
ClippedTextBoxMW(text,id,minwidth)
Wie 'ClippedTextBox()', mit Angabe der minimalen Breite
IntegerBox(integer,id,minwidth)
Ein Anzeigefeld fⁿr Integerzahlen
DEFINITIONEN
-/-
QuickHelp
*********
BESCHREIBUNG
Vielen Objekten kann ein kurzer Hilfstext zugeordnet werden, der in
einem kleinen Fenster angezeigt wird wenn sich der Mauszeiger ⁿber dem
zugeh÷rigen Objekt befindet.
FUNKTIONEN
QuickHelp(helpstring)
Dies ist ein Makro, das bei allen Objekten verwendet werden kann
Fⁿllmuster fⁿr Objekte
**********************
BESCHREIBUNG
Kennung Datenangabe Beschreibung
-------------------------------------------------------------------------------
TRAT_Backfill Fⁿllmuster
TRBF_WINDOWBACK Fenster-Hintergrund
TRBF_REQUESTERBACK Requester-Hintergrund
TRBF_NONE Hintergrund
TRBF_SHINE Farbe der hellen Kanten
TRBF_SHINE_SHADOW Farben der hellen und dunklen Kanten
TRBF_SHINE_FILL Farbe der hellen Kanten und Fⁿllfarbe
TRBF_SHINE_BACKGROUND Farbe der hellen Kanten und Hintergrund
TRBF_SHADOW Farbe der dunklen Kanten
TRBF_SHADOW_FILL Farbe der dunklen Kanten und Fⁿllfarbe
TRBF_SHADOW_BACKGROUND Farbe der dunklen Kanten und Hintergrund
TRBF_FILL Fⁿllfarbe
TRBF_FILL_BACKGROUND Fⁿllfarbe und Hintergrund
DEFINITIONEN
ObjectBackfillWin
Fenster-Hintergrund
ObjectBackfillReq
Requester-Hintergrund
ObjectBackfillB
Screen-Hintergrund
ObjectBackfillS
Farbe der hellen Kanten
ObjectBackfillSA
Farben der hellen und dunklen Kanten
ObjectBackfillSF
Farbe der hellen Kanten und Fⁿllfarbe
ObjectBackfillSB
Farbe der hellen Kanten und Hintergrundfarbe
ObjectBackfillA
Farbe der dunklen Kanten
ObjectBackfillAF
Farbe der dunklen Kanten und Fⁿllfarbe
ObjectBackfillAB
Farbe der dunklen Kanten und Hintergrundfarbe
ObjectBackfillF
Fⁿllfarbe
ObjectBackfillFB
Fⁿllfarbe und Hintergrundfarbe
Fⁿllmuster fⁿr Fenster
**********************
BESCHREIBUNG
Kennung Datenangabe Beschreibung
-------------------------------------------------------------------------------
TRWI_Backfill Fⁿllmuster
TRBF_WINDOWBACK Fenster-Hintergrund
TRBF_REQUESTERBACK Requester-Hintergrund
TRBF_NONE Hintergrund
TRBF_SHINE Farbe der hellen Kanten
TRBF_SHINE_SHADOW Farben der hellen und dunklen Kanten
TRBF_SHINE_FILL Farbe der hellen Kanten und Fⁿllfarbe
TRBF_SHINE_BACKGROUND Farbe der hellen Kanten und Hintergrund
TRBF_SHADOW Farbe der dunklen Kanten
TRBF_SHADOW_FILL Farbe der dunklen Kanten und Fⁿllfarbe
TRBF_SHADOW_BACKGROUND Farbe der dunklen Kanten und Hintergrund
TRBF_FILL Fⁿllfarbe
TRBF_FILL_BACKGROUND Fⁿllfarbe und Hintergrund
DEFINITIONEN
WindowBackfillWin
Fenster-Hintergrund
WindowBackfillReq
Requester-Hintergrund
WindowBackfillNone
Screen-Hintergrund
WindowBackfillS
Farbe der hellen Kanten
WindowBackfillSA
Farben der hellen und dunklen Kanten
WindowBackfillSF
Farbe der hellen Kanten und Fⁿllfarbe
WindowBackfillSB
Farbe der hellen Kanten und Hintergrundfarbe
WindowBackfillA
Farbe der dunklen Kanten
WindowBackfillAF
Farbe der dunklen Kanten und Fⁿllfarbe
WindowBackfillAB
Farbe der dunklen Kanten und Hintergrundfarbe
WindowBackfillF
Fⁿllfarbe
WindowBackfillFB
Fⁿllfarbe und Hintergrundfarbe
Funktionen der Library
**********************
Alle Funktionen k÷nnen auch ⁿber ein Alias aufgerufen werden, indem man dem
Funktionsnamen ein 'TRX_' voranstellt. Siehe Tips und Probleml÷sungen.
Triton-Funktionen
* TR_CreateApp() - Applikation erzeugen
* TR_DeleteApp() - Applikation l÷schen
* TR_OpenProject() - Projekt/Fenster ÷ffnen
* TR_CloseProject() - Projekt/Fenster schlie▀en
* TR_LockProject() - Projekt/Fenster fⁿr Eingaben sperren
* TR_UnlockProject() - Projekt/Fenster fⁿr Eingaben freigeben
* TR_LockScreen() - Bildschirm eines Projekts ⁿbernehmen
* TR_UnlockScreen() - Bildschirm eines Projekts freigeben
* TR_ObtainWindow() - Fenster eines Projekts ⁿbernehmen
* TR_ReleaseWindow() - Fenster eines Projekts freigeben
* TR_AutoRequest() - Fenster als Requester ÷ffnen
* TR_EasyRequest() - Einfachen Requester ÷ffnen
* TR_GetAttribute() - Attribut eines Objekts abfragen
* TR_SetAttribute() - Attribut eines Objekts Σndern
* TR_SendMessage() - Nachricht an ein Objekt schicken
* TR_Wait() - Auf Nachrichten einer Applikation warten
* TR_GetMsg() - Nachricht von einer Applikation empfangen
* TR_ReplyMsg() - Nachricht einer Applikation beantworten
* TR_HandleMsg() - Nachricht empfangen und beantworten
* TR_FirstOccurance() - Zeichen in einem Text suchen
* TR_NumOccurances() - Zeichen in einem Text zΣhlen
* TR_GetLastError() - Zuletzt aufgetretenen Fehler ermitteln
* TR_GetErrorString() - Fehlerbeschreibung anfordern
Datei- und Fontrequester
* ASL_RequestFile() - Datei-Requester aufrufen
* ASL_RequestFont() - Font-Requester aufrufen
Grafiken
* CreateImage() - Grafik von Disk laden
* DeleteImage() - Grafik aus dem Speicher l÷schen
Sonstiges
* ActivateProject() - Fenster eines Projekts aktivieren
* ProjectToFront() - Fenster eines Projekts nach vorne
* ProjectToBack() - Fenster eines Projekts nach hinten
* TritonRexxVersion() - Version der 'tritonrexx.library' ermitteln
* TritonVersion() - Version der 'triton.library' ermitteln
Die Funktion TR_CreateApp() - Applikation erzeugen
**************************************************
NAME
app = TR_CreateApp(taglist)
BESCHREIBUNG
Erzeugt eine Applikation. Eine Applikation ist die Grundlage fⁿr alle
Fenster, daher mu▀ diese Funktion immer aufgerufen werden bevor Fenster
ge÷ffnet werden k÷nnen.
ARGUMENTE
taglist - Eine Tagliste, die die Beschreibung der Applikation enthΣlt.
Siehe Applikationen.
ERGEBNIS
app - Eine Kennzahl fⁿr die erzeugte Applikation im binΣren Format.
'00000000'x wenn die Applikation nicht erzeugt werden konnte.
SIEHE AUCH
TR_DeleteApp()
Die Funktion TR_DeleteApp() - Applikation l÷schen
*************************************************
NAME
dummy = TR_DeleteApp(app)
BESCHREIBUNG
L÷scht eine zuvor mit 'TR_CreateApp()' erzeugte Applikation. Alle zu
dieser Applikation geh÷renden Projekte/Fenster werden ebenfalls
geschlossen!
ARGUMENTE
app - Die Kennzahl der Applikation, die gel÷scht werden soll
Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_CreateApp()
Die Funktion TR_OpenProject() - Projekt/Fenster ÷ffnen
******************************************************
NAME
project = TR_OpenProject(app,taglist)
BESCHREIBUNG
╓ffnet ein Projekt/Fenster
ARGUMENTE
app - Die Kennzahl der Applikation, zu der das Fenster geh÷rt.
Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
taglist - Tagliste, die die Beschreibung des Projekts enthΣlt. Die
Eigenschaften mⁿssen in der Tagliste in einer bestimmten
Reihenfolge angegeben werden:
1. Fensterbeschreibung Siehe Projekte-Fenster.
2. Menⁿbeschreibungen Siehe Menⁿs.
3. Objektbeschreibungen Siehe Objekte und Attribute.
ERGEBNIS
project - Eine Kennzahl fⁿr das ge÷ffnete Projekt im binΣren Format.
'00000000'x wenn das Projekt nicht ge÷ffnet werden konnte.
SIEHE AUCH
TR_CreateApp() TR_CloseProject()
Die Funktion TR_CloseProject() - Projekt/Fenster schlie▀en
**********************************************************
NAME
dummy = TR_CloseProject(project)
BESCHREIBUNG
Schlie▀t ein zuvor mit 'TR_OpenProject()' ge÷ffnetes Projekt.
ARGUMENTE
project - Die Kennzahl des Projekts, das gel÷scht werden soll.
Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_OpenProject()
Die Funktion TR_LockProject() - Projekt/Fenster fⁿr Eingaben sperren
********************************************************************
NAME
dummy = TR_LockProject(project)
BESCHREIBUNG
Sperrt ein Projekt. Im Fenster des gesperrten Projekts sind keinerlei
Eingaben mehr m÷glich. Das Verkleinern und Vergr÷▀ern des Fensters
ist jedoch weiterhin m÷glich.
ARGUMENTE
project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_OpenProject() TR_UnlockProject()
Die Funktion TR_UnlockProject() - Projekt/Fenster fⁿr Eingaben freigeben
************************************************************************
NAME
dummy = TR_UnlockProject(project)
BESCHREIBUNG
Gibt ein zuvor gesperrtes Projekt wieder fⁿr Eingaben frei.
ARGUMENTE
project - Die Kennzahl des Projekts, das freigegeben werden soll.
Dies ist der gleiche Wert, der zuvor bei 'TR_LockProject()'
angegeben wurde.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_LockProject()
Die Funktion TR_LockScreen() - Bildschirm eines Projekts ⁿbernehmen
*******************************************************************
NAME
screen = TR_LockScreen(project)
BESCHREIBUNG
Liefert einen Zeiger auf den Bildschirm des angegebenen Projekts, und
verhindert, da▀ der Bildschirm geschlossen werden kann. Der Bildschirm
kann jetzt gefahrlos zum ╓ffnen von anderen Fenstern verwendet werden.
ARGUMENTE
project - Die Kennzahl des Projekts, dessen Bildschirm ⁿbernommen werden
soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
screen - Zeiger auf die Screen-Struktur des Bildschirms im binΣren
Format, '00000000'x im Fehlerfall.
SIEHE AUCH
TR_OpenProject() TR_UnlockScreen()
Die Funktion TR_UnlockScreen() - Bildschirm eines Projekts freigeben
********************************************************************
NAME
dummy = TR_UnlockScreen(screen)
BESCHREIBUNG
Gibt einen zuvor mit 'TR_LockScreen()' ⁿbernommenen Bildschirm frei. Der
Bildschirm kann erst nach dem Aufruf dieser Funktion wieder geschlossen
werden.
ARGUMENTE
screen - Zeiger auf die Screen-Struktur des Bildschirms, der freigegeben
werden soll. Dies ist der Rⁿckgabewert von 'TR_LockScreen()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_LockScreen()
Die Funktion TR_ObtainWindow() - Fenster eines Projekts ⁿbernehmen
******************************************************************
NAME
window = TR_ObtainWindow(project)
BESCHREIBUNG
Liefert einen Zeiger auf das Fenster des angegebenen Projekts, und
erlaubt es das Fenster mit 'Nicht-Triton-Funktionen' zu manipulieren.
Man kann z.B. das Fenster nach vorne oder hinten legen, aktivieren oder
deaktivieren.
Der Inhalt des Fensters darf auf keinen Fall verΣndert
werden! Das Fenster mu▀ spΣter mit 'TR_ReleaseWindow()' wieder
freigegeben werden.
ARGUMENTE
project - Die Kennzahl des Projekts, dessen Fenster ⁿbernommen werden
soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
window - Zeiger auf die Window-Struktur des Fensters im binΣren
Format, '00000000'x im Fehlerfall.
SIEHE AUCH
TR_OpenProject() TR_ReleaseWindow() ProjectToFront() ProjectToBack()
Die Funktion TR_ReleaseWindow() - Fenster eines Projekts freigeben
******************************************************************
NAME
dummy = TR_ReleaseWindow(window)
BESCHREIBUNG
Gibt ein zuvor mit 'TR_ObtainWindow()' ⁿbernommenes Fenster frei.
ARGUMENTE
window - Zeiger auf die Window-Struktur des Fensters, das freigegeben
werden soll. Dies ist der Rⁿckgabewert von 'TR_ObtainWindow()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_ObtainWindow()
Die Funktion ActivateProject() - Fenster eines Projekts aktivieren
******************************************************************
NAME
dummy = ActivateProject(project)
BESCHREIBUNG
Aktiviert das zum angegebenen Projekt geh÷rende Fenster.
ARGUMENTE
project - Die Kennzahl des Projekts, dessen Fenster aktiviert werden
soll, Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
ProjectToBack() ProjectToFront() TR_ObtainWindow() TR_ReleaseWindow()
Die Funktion ProjectToFront() - Fenster eines Projekts nach vorne
*****************************************************************
NAME
dummy = ProjectToFront(project)
BESCHREIBUNG
Bringt das zum angegebenen Projekt geh÷rende Fenster in den Vordergrund.
ARGUMENTE
project - Die Kennzahl des Projekts, dessen Fenster in den Vordergrund
gebracht werden soll, Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
ActivateProject() ProjectToBack() TR_ObtainWindow() TR_ReleaseWindow()
Die Funktion ProjectToBack() - Fenster eines Projekts nach hinten
*****************************************************************
NAME
dummy = ProjectToBack(project)
BESCHREIBUNG
Bringt das zum angegebenen Projekt geh÷rende Fenster in den Hintergrund.
ARGUMENTE
project - Die Kennzahl des Projekts, dessen Fenster in den Hintergrund
gebracht werden soll, Rⁿckgabewert von 'TR_OpenProject()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
ActivateProject() ProjectToFront() TR_ObtainWindow() TR_ReleaseWindow()
Die Funktion TR_AutoRequest() - Fenster als Requester ÷ffnen
************************************************************
NAME
auswahl = TR_AutoRequest(app,project,taglist)
BESCHREIBUNG
╓ffnet einen durch die Tagliste beschriebenen Requester. Sobald eine
Nachricht vom Typ 'TRMS_ACTION' eintrifft wird der Requester sofort
wieder geschlossen. Wenn ein Projekt angegeben ist, wird dieses in der
Zeit, in der der Requester ge÷ffnet ist, fⁿr Eingaben gesperrt.
ARGUMENTE
app - Die Kennzahl der Applikation, zu der der Requester geh÷rt.
Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
'00000000'x wenn kein Projekt gesperrt werden soll.
taglist - Tagliste, die die Beschreibung des Requesters enthΣlt.
Siehe TR_OpenProject().
ERGEBNIS
auswahl - Die ID-Nummer des Objekts, das die 'TRMS_ACTION'-Nachricht
ausgel÷st hat. -1 wenn das Schlie▀symbol des Fensters
angeklickt wurde.
SIEHE AUCH
TR_EasyRequest()
Die Funktion TR_EasyRequest() - Einfachen Requester ÷ffnen
**********************************************************
NAME
auswahl = TR_EasyRequest(app,text,gadgets,taglist)
BESCHREIBUNG
╓ffnet einen einfachen Requester.
ARGUMENTE
app - Die Kennzahl der Applikation, zu der der Requester geh÷rt.
Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
text - Text, der im Requester dargestellt werden soll.
gadgets - Die Texte in den Gadgets des Requesters, getrennt durch '|'.
taglist - Eine Tagliste, die die Eigenschaften des Requesters enthΣlt.
Kennung Datenangabe Beschreibung
-----------------------------------------------------------------
TREZ_ReqPos Position Die Position des Requesters auf
dem Bildschirm, hier gilt das
gleiche wie beim ╓ffnen eines
Projekts/Fensters. Standard ist
'TRWP_MOUSEPOINTER'.
Siehe Projekte-Fenster.
TREZ_LockProject Projekt Die von 'TR_OpenProject()'
erhaltene Kennzahl eines Projekts,
das solange der Requester ge÷ffnet
ist fⁿr Eingaben gesperrt werden
soll. Der Requester wird auf dem
Bildschirm des hier angegebenen
Projekts ge÷ffnet.
Achtung:
---------------------------------
Die Projekt-Kennzahl liegt im
binΣren Format vor! Sie kann hier
nicht einfach angegeben werden,
sondern mu▀ vorher in eine Zahl
umgewandelt werden! Dazu wird die
ARexx-Funktion 'C2D()' verwendet!
TREZ_Return Integer Die Nummer des Gadgets, das mit
RETURN angewΣhlt werden kann.
Standard ist 1, bei Requestern mit
nur einem Gadget 0.
TREZ_Title Zeichenkette Der Fenstertitel des Requesters.
Standard ist 'System-Request'.
TREZ_Activate Bool Gibt an ob der Requester aktiviert
ist. Wenn dies nicht angegeben ist
wird der Zustand des Requesters
von dem bei 'TREZ_LockProject'
angegebenen Projekt ⁿbernommen.
ERGEBNIS
auswahl - Die Nummer des angewΣhlten Gadgets, -1 wenn ein Fehler
aufgetreten ist. Die Gadgets werden von links nach rechts
durchnummeriert, beginnend bei 1. Das ganz rechte Gadget
hat die Nummer 0.
SIEHE AUCH
TR_AutoRequest()
Die Funktion TR_GetAttribute() - Attribut eines Objekts abfragen
****************************************************************
NAME
value = TR_GetAttribute(project,id,attribute)
BESCHREIBUNG
Eigenschaft eines Objekts oder Projekts abfragen. Eigenschaften von
Objekten k÷nnen nur abgefragt werden wenn das Objekt eine ID-Nummer
besitzt.
ARGUMENTE
project - Die Kennzahl des Projekts, welches das abzufragende Objekt
enthΣlt. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
id - ID-Nummer des Objekts, das abgefragt werden soll. Wenn eine
Eigenschaft des Projekts abgefragt werden soll mu▀ hier 0
angegeben werden.
attribute - Die Kennung der Eigenschaft, die abgefragt werden soll. Wenn
die Standard-Eigenschaft eines Objekts abgefragt werden soll
mu▀ hier die Kennung des Objekts selbst angegeben werden!
z.B. 'TROB_String', wenn der in einem Eingabefeld enthaltene
Text abgefragt werden soll.
ERGEBNIS
value - Der abgefragte Wert. Dieser Wert hat je nach Objekt und
Eigenschaft ein ganz bestimmtes Format. Es gilt immer das,
was auch beim ╓ffnen eines Projekts angegeben wird.
Siehe Taglisten verwenden.
Siehe Projekte-Fenster.
Siehe Menⁿs.
Siehe Objekte und Attribute.
SIEHE AUCH
TR_SetAttribute()
Die Funktion TR_SetAttribute() - Attribut eines Objekts Σndern
**************************************************************
NAME
dummy = TR_SetAttribute(project,id,attribute,value)
BESCHREIBUNG
Eigenschaft eines Objekts oder Projekts Σndern. Eigenschaften von
Objekten k÷nnen nur geΣndert werden wenn das Objekt eine ID-Nummer
besitzt.
ARGUMENTE
project - Die Kennzahl des Projekts, welches das zu Σndernde Objekt
enthΣlt. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
id - ID-Nummer des Objekts, das geΣndert werden soll. Wenn eine
Eigenschaft des Projekts geΣndert werden soll mu▀ hier 0
angegeben werden.
attribute - Die Kennung der Eigenschaft, die geΣndert werden soll. Wenn
die Standard-Eigenschaft eines Objekts geΣndert werden soll
mu▀ hier die Kennung des Objekts selbst angegeben werden!
z.B. 'TROB_String', wenn ein neuer Text in einem Eingabefeld
angezeigt werden soll.
value - Der Wert, der neu eingestellt werden soll. Dieser Wert mu▀
je nach Objekt und Eigenschaft ein ganz bestimmtes Format
haben. Es gilt immer das, was auch beim ╓ffnen eines Projekts
angegeben wird.
Siehe Taglisten verwenden.
Siehe Projekte-Fenster.
Siehe Menⁿs.
Siehe Objekte und Attribute.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_GetAttribute()
Die Funktion TR_SendMessage() - Nachricht an ein Objekt schicken
****************************************************************
NAME
dummy = TR_SendMessage(project,id,message,data)
BESCHREIBUNG
Sendet eine Nachricht an ein Objekt oder Projekt.
ARGUMENTE
project - Die Kennzahl des Projekts, welches das Objekt enthΣlt.
Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
id - ID-Nummer des Objekts, an das die Nachricht geschickt
werden soll. Soll die Nachricht an das Projekt geschickt
werden, dann mu▀ hier 0 angegeben werden.
message - Die Kennung der Nachricht, die verschickt werden soll.
data - Die Daten, die mit der Nachricht ⁿbermittelt werden sollen.
message data Beschreibung
-------------------------------------------------------------
TROM_ACTIVATE Ungenutzt Aktiviert ein Objekt
z.B.: Aktivieren eines Texteingabefeldes mit der ID 7
CALL TR_SendMessage(project,7,'TROM_ACTIVATE',0)
ERGEBNIS
dummy - immer 1
SIEHE AUCH
-/-
Die Funktion TR_GetMsg() - Nachricht von einer Applikation empfangen
********************************************************************
NAME
message = TR_GetMsg(app,stemvar)
BESCHREIBUNG
EmpfΣngt eine Nachricht von eine Applikation. Jede erhaltene Nachricht
mu▀ unbedingt mit der Funktion 'TR_ReplyMsg()' beantwortet werden!
ARGUMENTE
app - Die Kennzahl der Applikation, von der eine Nachricht empfangen
werden soll. Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
stemvar - Eine Stem-Variable, in der die Daten der Nachricht gespeichert
werden sollen. Die Daten werden wie folgt gespeichert:
stemvar.trm_project
Die Kennzahl des zur Nachricht geh÷renden Projekts im
binΣren Format
stemvar.trm_id
Die ID-Nummer des Objekts, das die Nachricht ausgel÷st hat
stemvar.trm_class
Die Art der Nachricht:
TRMS_CLOSEWINDOW - Das Fenster soll geschlossen werden,
Schlie▀symbol wurde angeklickt oder
ESC wurde gedrⁿckt.
TRMS_ERROR - Ein Fehler ist aufgetreten, der
Fehlercode steht in 'stemvar.trm_data'.
TRMS_NEWVALUE - Daten eines Objekt wurden verΣndert, der
neue Wert steht in 'stemvar.trm_data'.
z.B. Neuer Text im Eingabefeld oder der
gerade ausgewΣhlte Eintrag in einem
Listview-Objekt.
TRMS_ACTION - Objekt l÷st eine Aktion aus, z.B. wenn
ein Knopf angewΣhlt wurde.
TRMS_ICONDROPPED - Ein oder mehrere Icons wurden auf dem
Fenster, dann ist 'stemvar.trm_id' = 0,
oder einem 'DropBox'-Objekt, dann ist
'stemvar.trm_id' die ID-Nummer, fallen
gelassen. Die Pfadnamen der Icons stehen
in 'stemvar.trm_data':
stemvar.trm_data.0 - Anzahl der Icons
stemvar.trm_data.1 - erster Pfadname
stemvar.trm_data.2 - zweiter Pfadname
stemvar.trm_data.3 - dritter Pfadname
stemvar.trm_data.n - n'ter Pfadname
TRMS_KEYPRESSED - Eine Taste wurde gedrⁿckt, die Tastencodes
werden wie folgt gespeichert:
stemvar.trm_data - ASCII-Code
stemvar.trm_code - Tastatur-Code
stemvar.trm_qualifier - Qualifier-Code
TRMS_HELP - Der User fordert Hilfe fⁿr das Objekt
mit der in 'stemvar.trm_id' gespeicherten
ID-Nummer an.
TRMS_DISKINSERTED - Eine Diskette wurde eingelegt.
TRMS_DISKREMOVED - Eine Diskette wurde entnommen.
stemvar.trm_data
Daten, je nach Art der Nachricht
stemvar.trm_code
Tastaturcode bei 'TRMS_KEYPRESSED'
stemvar.trm_qualifier
Qualifiercode
stemvar.trm_seconds
Aktuelle Systemzeit in Sekunden seit dem 01.01.1978
stemvar.trm_micros
Microsekunden-Wert der Systemzeit
stemvar.trm_app
Die Kennzahl der zur Nachricht geh÷renden Applikation im
binΣren Format.
ERGEBNIS
message - Eine Kennzahl fⁿr die empfangene Nachricht im binΣren Format.
Diese Kennzahl mu▀ beim Beantworten der Nachricht mittels
'TR_ReplyMsg()' wieder angegeben werden! Alle Nachrichten
mⁿssen so schnell wie m÷glich beantwortet werden, um eine
reibungslose Funktion zu gewΣhrleisten!
SIEHE AUCH
TR_Wait() TR_ReplyMsg() TR_HandleMsg()
Die Funktion TR_ReplyMsg() - Nachricht einer Applikation beantworten
********************************************************************
NAME
dummy = TR_ReplyMsg(message)
BESCHREIBUNG
Beantwortet eine Nachricht, die mit 'TR_GetMsg()' empfangen wurde.
ARGUMENTE
message - Die Kennzahl der Nachricht, die beantwortet werden soll.
Dies ist der Rⁿckgabewert von 'TR_GetMsg()'.
ERGEBNIS
dummy - immer 1
SIEHE AUCH
TR_Wait() TR_GetMsg() TR_HandleMsg()
Die Funktion TR_Wait() - Nachricht einer Applikation beantworten
****************************************************************
NAME
signale = TR_Wait(app,signale)
BESCHREIBUNG
Wartet bis die angegebene Applikation eine Nachricht bereitstellt, oder
auf das Auftreten von einem der angegebenen Unterbrechungs-Signale.
ARGUMENTE
app - Die Kennzahl der Applikation, auf die gewartet werden soll.
signale - Hier k÷nnen Signale angegeben werden, auf die zusΣtzlich
gewartet werden soll. Es wird ein Text angegeben, der die
folgenden Buchstaben enthalten kann:
C - es wird zusΣtzlich auf CTRL-C gewartet
D - es wird zusΣtzlich auf CTRL-D gewartet
E - es wird zusΣtzlich auf CTRL-E gewartet
F - es wird zusΣtzlich auf CTRL-F gewartet
z.B. 'CF' - wartet auf CTRL-C und CTRL-F
'' - wartet auf keine zusΣtzlichen Signale
ERGEBNIS
signale - Die aufgetretenen Signale im oben beschriebenen Format.
SIEHE AUCH
TR_GetMsg() TR_ReplyMsg() TR_HandleMsg()
Die Funktion TR_HandleMsg() - Nachricht einer Applikation empfangen und beantworten
***********************************************************************************
NAME
bool = TR_HandleMsg(app,stemvar)
BESCHREIBUNG
Erfⁿllt den gleichen Zweck wie die Funktionen 'TR_GetMsg()' und
'TR_ReplyMsg()' zusammen, die empfangene Nachricht wird automatisch
beantwortet!
ARGUMENTE
app - Die Kennzahl der Applikation, von der eine Nachricht empfangen
werden soll. Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
stemvar - Stem-Variable, in der die Daten der Nachricht gespeichert
werden sollen. Siehe TR_GetMsg().
ERGEBNIS
bool - 1 wenn eine korrekte Nachricht empfangen wurde, 0 wenn nicht
SIEHE AUCH
TR_Wait() TR_GetMsg() TR_ReplyMsg()
Die Funktion TR_FirstOccurance() - Zeichen in einem Text suchen
***************************************************************
NAME
position = TR_FirstOccurance(char,string)
BESCHREIBUNG
Sucht in einer Zeichenkette nach dem ersten Auftreten eines Zeichens.
ARGUMENTE
char - Das Zeichen, nach dem gesucht werden soll.
string - Die Zeichenkette, die durchsucht werden soll.
ERGEBNIS
position - Die Position, an der das Zeichen zum ersten Mal auftritt.
Das erste Zeichen hat die Nummer 1. 0 bedeutet, da▀ das
Zeichen nicht in der Zeichenkette vorkommt.
SIEHE AUCH
TR_NumOccurances()
Die Funktion TR_NumOccurances() - Zeichen in einem Text zΣhlen
**************************************************************
NAME
count = TR_NumOccurances(char,string)
BESCHREIBUNG
ZΣhlt, wie oft ein Zeichen in einer Zeichenkette enthalten ist.
ARGUMENTE
char - Das Zeichen, das gezΣhlt werden soll.
string - Die Zeichenkette, die durchsucht werden soll.
ERGEBNIS
count - Die Anzahl, wie oft das zeichen in der Zeichenkette
enthalten ist.
SIEHE AUCH
TR_FirstOccurance()
Die Funktion TR_GetLastError() - Zuletzt aufgetretenen Fehler ermitteln
***********************************************************************
NAME
error = TR_GetLastError(app)
BESCHREIBUNG
Ermittelt die Nummer des bei einer Applikation zuletzt aufgetretenen
Fehlers.
ARGUMENTE
app - Die Kennzahl der Applikation, deren letzter Fehler ermittelt
werden soll.
ERGEBNIS
error - Die Nummer des zuletzt aufgetretenen Fehlers.
SIEHE AUCH
TR_GetErrorString()
Die Funktion TR_GetErrorString() - Fehlerbeschreibung anfordern
***************************************************************
NAME
string = TR_GetErrorString(error)
BESCHREIBUNG
Besorgt die Beschreibung eines Fehlers im Klartext.
ARGUMENTE
error - Die Nummer des Fehlers, diese Nummer kann z.B. mit der
Funktion 'TR_GetLastError()' ermittelt werden.
ERGEBNIS
string - Die Fehlerbeschreibung im Klartext.
SIEHE AUCH
TR_GetLastError()
Die Funktion ASL_RequestFile() - Datei-Requester aufrufen
*********************************************************
NAME
bool = ASL_RequestFile(project,stemvar,taglist)
BESCHREIBUNG
Ruft den Datei-Requester der 'asl.library' auf.
ARGUMENTE
project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
soll wΣhrend der Requester ge÷ffnet ist. '00000000'x wenn
kein Projekt gesperrt werden soll.
stemvar - Stem-Variable, in der die im Requester ausgewΣhlten Datei-
oder Verzeichnisnamen gespeichert werden sollen:
stemvar.0 - Anzahl der ausgewΣhlten Dateien
stemvar.1 - Pfadname der ersten ausgewΣhlten Datei
stemvar.2 - Pfadname der zweiten ausgewΣhlten Datei
stemvar.3 - Pfadname der dritten ausgewΣhlten Datei
stemvar.n - Pfadname der n'ten ausgewΣhlten Datei
taglist - Eine Tagliste, die die Eigenschaften des Requesters beschreibt:
Kennung Datenangabe Beschreibung
-----------------------------------------------------------------
ASLFR_PubScreenName Zeichenkette Name des ÷ffentlichen
Bildschirms, auf dem
der Requester ge÷ffnet
werden soll.
ASLFR_Screen Zeiger Zeiger auf die Screen-
Struktur eines Bild-
schirms, auf dem der
Requester ge÷ffnet
werden soll.
ASLFR_TextAttr TextAttr-Struktur Stem-Variable, die die
TextAttr-Struktur fⁿr
den Requester enthΣlt
Siehe Taglisten verwenden.
ASLFR_TitleText Zeichenkette Text in der Titelzeile
ASLFR_PositiveText Zeichenkette Text fⁿr 'Okay'
ASLFR_NegativeText Zeichenkette Text fⁿr 'Abbruch'
ASLFR_InitialLeftEdge Integer Linke Ecke des Fensters
ASLFR_InitialTopEdge Integer Obere Ecke des Fensters
ASLFR_InitialWidth Integer Breite des Fensters
ASLFR_InitialHeight Integer H÷he des Fensters
ASLFR_InitialFile Zeichenkette Dateiname, der beim
╓ffnen eingetragen
werden soll.
ASLFR_InitialDrawer Zeichenkette Verzeichnis, das beim
╓ffnen eingetragen
werden soll.
ASLFR_InitialPattern Zeichenkette Muster, das beim
╓ffnen eingetragen
werden soll.
ASLFR_DoSaveMode Bool 1 = Speichern-Modus
ASLFR_DoMultiSelect Bool 1 = Mehrfachauswahl
ASLFR_DoPatterns Bool 1 = Muster-Gadget
ASLFR_DrawersOnly Bool 1 = Verzeichnisauswahl
ASLFR_RejectIcons Bool 1 = keine Icons anz.
ASLFR_RejectPattern Zeichenkette Dateien, auf die das
hier angegebene Muster
pa▀t werden nicht
angezeigt.
ASLFR_AcceptPattern Zeichenkette Nur Dateien, auf die
das hier angegebene
Muster pa▀t, werden
angezeigt.
ASLFR_FilterDrawers Bool 1 = auch Verzeichnisse
mit den Mustern
vergleichen
Zum Erstellen von Taglisten fⁿr Standard-Requester
stehen einige Funktionen zur Verfⁿgung:
-------------------------------------------------
LoadFile(title,okay,dir,file)
Datei zum Laden auswΣhlen
LoadFileI(title,okay,dir,file)
Datei zum Laden auswΣhlen, Icons anzeigen
LoadFileP(title,okay,dir,file,pattern)
Datei zum Laden auswΣhlen, Muster-Eingabefeld
LoadFileIP(title,okay,dir,file,pattern)
Datei zum Laden auswΣhlen, Muster-Eingabefeld, Icons anzeigen
LoadFileM(title,okay,dir,file)
Mehrere Dateien auswΣhlen
LoadFileMI(title,okay,dir,file)
Mehrere Dateien auswΣhlen, Icons anzeigen
LoadFileMP(title,okay,dir,file,pattern)
Mehrere Dateien auswΣhlen, Muster-Eingabefeld
LoadFileMIP(title,okay,dir,file,pattern)
Mehrere Dateien auswΣhlen, Muster-Eingabefeld, Icons anzeigen
SaveFile(title,okay,dir,file)
Datei zum Speichern auswΣhlen
SaveFileI(title,okay,dir,file)
Datei zum Speichern auswΣhlen, Icons anzeigen
SaveFileP(title,okay,dir,file,pattern)
Datei zum Speichern auswΣhlen, Muster-Eingabefeld
SaveFileIP(title,okay,dir,file,pattern)
Datei zum Speichern auswΣhlen, Muster-Eingabefeld, Icons anzeigen
GetDrawer(title,okay,dir)
Verzeichnis auswΣhlen
GetDrawerP(title,okay,dir,pattern)
Verzeichnis auswΣhlen, Muster-Eingabefeld
ERGEBNIS
bool - 1 wenn etwas ausgewΣhlt wurde, 0 wenn nicht
SIEHE AUCH
-/-
Die Funktion ASL_RequestFont() - Font-Requester aufrufen
********************************************************
NAME
bool = ASL_RequestFont(project,stemvar,taglist)
BESCHREIBUNG
Ruft den Font-Requester der 'asl.library' auf.
ARGUMENTE
project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
soll wΣhrend der Requester ge÷ffnet ist. '00000000'x wenn
kein Projekt gesperrt werden soll.
stemvar - Stem-Variable, in der der im Requester ausgewΣhlte Font
gespeichert werden soll:
stemvar.ta_name - Name des ausgewΣhlten Fonts
stemvar.ta_ysize - Gr÷▀e des ausgewΣhlten Fonts
stemvar.ta_style - Stil des ausgewΣhlten Fonts
stemvar.ta_flags - Flags des ausgewΣhlten Fonts
stemvar.drawmode - der ausgewΣhlte Zeichenmodus
taglist - Eine Tagliste, die die Eigenschaften des Requesters beschreibt:
Kennung Datenangabe Beschreibung
----------------------------------------------------------------
ASLFO_PubScreenName Zeichenkette Name des ÷ffentlichen
Bildschirms, auf dem
der Requester ge÷ffnet
werden soll.
ASLFO_Screen Zeiger Zeiger auf die Screen-
Struktur eines Bild-
schirms, auf dem der
Requester ge÷ffnet
werden soll.
ASLFO_TextAttr TextAttr-Struktur Stem-Variable, die die
TextAttr-Struktur fⁿr
den Requester enthΣlt
Siehe Taglisten verwenden.
ASLFO_TitleText Zeichenkette Text in der Titelzeile
ASLFO_PositiveText Zeichenkette Text fⁿr 'Okay'
ASLFO_NegativeText Zeichenkette Text fⁿr 'Abbruch'
ASLFO_InitialLeftEdge Integer Linke Ecke des Fensters
ASLFO_InitialTopEdge Integer Obere Ecke des Fensters
ASLFO_InitialWidth Integer Breite des Fensters
ASLFO_InitialHeight Integer H÷he des Fensters
ASLFO_InitialName Zeichenkette Name des Fonts, der
beim ╓ffnen ausgewΣhlt
sein soll.
ASLFO_InitialSize Integer Gr÷▀e des Fonts, der
beim ╓ffnen ausgewΣhlt
sein soll.
ASLFO_InitialStyle Integer Stil des Fonts, der
beim ╓ffnen ausgewΣhlt
sein soll.
ASLFO_InitialFlags Integer Flags des Fonts, der
beim ╓ffnen ausgewΣhlt
sein soll.
ASLFO_InitialDrawMode Integer Zeichenmodus des Fonts,
der beim ╓ffnen
ausgewΣhlt sein soll.
ASLFO_DoStyle Bool 1 = Stil abfragen
ASLFO_DoDrawMode Bool 1 = Zeichenmodus
abfragen
ASLFO_FixedWidthOnly Bool 1 = Nur Fonts anzeigen,
die eine feste
Zeichenbreite haben.
ASLFO_MinHeight Integer Nur Fonts anzeigen, die
mindestens die hier
angegebene Gr÷▀e haben
ASLFO_MaxHeight Integer Nur Fonts anzeigen, die
h÷chstens die hier
angegebene Gr÷▀e haben
ASLFO_ModeList EintrΣge Stem-Variable, die die
EintrΣge enthΣlt, die
im Zeichenmodus-Gadget
angezeigt werden sollen
Zum Erstellen von Taglisten fⁿr Standard-Requester
stehen einige Funktionen zur Verfⁿgung:
-------------------------------------------------
GetFont(title,okay,fontname,size)
Proportional-Font auswΣhlen
GetFWFont(title,okay,fontname,size)
Font mit fester Zeichenbreite auswΣhlen
ERGEBNIS
bool - 1 wenn etwas ausgewΣhlt wurde, 0 wenn nicht
SIEHE AUCH
-/-
Die Funktion CreateImage() - Grafik von Disk laden
**************************************************
NAME
bool = CreateImage(imagename,filename,taglist) (Ab Kickstart 3.0)
BESCHREIBUNG
LΣdt eine Grafik von Disk und bereitet diese fⁿr die Anzeige in einem
Fenster vor. Jede geladene Grafik mu▀ spΣtestens am Ende des Skripts
mit 'DeleteImage()' wieder aus dem Speicher gel÷scht werden.
ARGUMENTE
imagename - Ein logischer Name fⁿr die Grafik. Der hier angegebene Name
dient als Parameter fⁿr alle Funktionen und Taglisten, bei
denen die Grafik verwendet werden soll.
Siehe Taglisten verwenden.
filename - Der Pfadname der Grafikdatei, die geladen werden soll. Die
Datei wird mit Hilfe der 'datatypes.library' geladen, es sind
alle Formate erlaubt, fⁿr die Datatypes installiert sind.
taglist - Tagliste, die die Eigenschaften der Grafik beschreibt:
Kennung Datenangabe Beschreibung
---------------------------------------------------------------
TRXIM_PubScreenName Zeichenkette Name eines ÷ffentlichen
Bildschirms, an dessen
Farbpalette die Grafik
angepasst werden soll
TRXIM_Screen Zeiger Screen-Struktur eines
Bildschirms, an dessen
Farbpalette die Grafik
angepasst werden soll
TRXIM_Flags Flags
TRXIF_CENTER Die Grafik wird immer
im Darstellungsbereich
zentriert gezeichnet.
Standard ist die linke,
obere Ecke
TRXIF_SCALE Die Grafik wird immer
genau an die die Gr÷▀e
des Darstellungsbereichs
angepasst.
StandardmΣ▀ig wird die
Gr÷▀e der Grafik nicht
verΣndert.
TRXIF_PROP Aeim Anpassen an die Gr÷▀e
des Darstellungsbereichs
bleibt das SeitenverhΣltnis
der Grafik immer gleich.
Nur in Verbindung mit dem
Flag 'TRIXIF_SCALE'
ERGEBNIS
bool - 1 wenn alles geklappt hat, 0 im Fehlerfall
SIEHE AUCH
DeleteImage() ImageWidth() ImageHeight()
Die Funktion DeleteImage() - Grafik aus dem Speicher l÷schen
************************************************************
NAME
bool = DeleteImage(imagename)
BESCHREIBUNG
L÷scht eine zuvor mit 'CreateImage()' geladene Grafik aus dem Speicher.
Eine Grafik kann erst gel÷scht werden wenn sie von keinem Projekt mehr
benutzt wird! 'CreateImage()' kann immer gefahrlos aufgerufen werden,
auch wenn keine Grafik mit dem angegebenen Namen vorher geladen wurde!
ARGUMENTE
imagename - Der logische Name der Grafik, die gel÷scht werden soll.
ERGEBNIS
bool - 1 wenn die Grafik gel÷scht wurde. Wenn die Grafik nicht
gel÷scht werden konnte wird 0 zurⁿckgegeben. Dies passiert
wenn die Grafik noch im Fenster eines Projekts dargestellt
wird, oder eine Grafik mit dem angegebenen Namen nicht
existiert.
SIEHE AUCH
CreateImage() ImageWidth() ImageHeight()
Die Funktion ImageWidth()
*************************
NAME
width = ImageWidth(imagename)
BESCHREIBUNG
Ermittelt die Breite einer Grafik. Es wird immer die Breite der nicht
skalierten Grafik zurⁿckgegeben.
ARGUMENTE
imagename - Der logische Name einer mit 'CreateImage()' geladenen Grafik,
ERGEBNIS
width - Die Breite der Grafik in Pixel
SIEHE AUCH
CreateImage() DeleteImage() ImageHeight()
Die Funktion ImageHeight()
**************************
NAME
height = ImageHeight(imagename)
BESCHREIBUNG
Ermittelt die H÷he einer Grafik. Es wird immer die H÷he der nicht
skalierten Grafik zurⁿckgegeben.
ARGUMENTE
imagename - Der logische Name einer mit 'CreateImage()' geladenen Grafik
ERGEBNIS
height - Die H÷he der Grafik in Pixel
SIEHE AUCH
CreateImage() DeleteImage() ImageWidth()
Die Funktion TritonRexxVersion() - Version der 'tritonrexx.library' ermitteln
*****************************************************************************
NAME
version = TritonRexxVersion()
BESCHREIBUNG
Gibt die Version der 'tritonrexx.library' zurⁿck.
ARGUMENTE
-/-
ERGEBNIS
version - Die Version der Library, z.B. 37.2
SIEHE AUCH
TritonVersion()
Die Funktion TritonVersion() - Version der 'triton.library' ermitteln
*********************************************************************
NAME
version = TritonVersion()
BESCHREIBUNG
Gibt die Version der 'triton.library' zurⁿck.
ARGUMENTE
-/-
ERGEBNIS
version - Die Version der Library, z.B. 4.39
SIEHE AUCH
TritonRexxVersion()
Index und Stichwortverzeichnis
******************************
▄bersicht ▄bersicht
ActivateProject() ActivateProject()
Adresse des Autors Adresse des Autors
Applikation erzeugen TR_CreateApp()
Applikation l÷schen TR_DeleteApp()
Applikationen Applikationen und Projekte
Applikationen Applikationen
Applikationen und Projekte Applikationen und Projekte
ASL_RequestFile() ASL_RequestFile()
ASL_RequestFont() ASL_RequestFont()
Attribute Σndern TR_SetAttribute()
Attribute abfragen TR_GetAttribute()
Auswahl von Farben Palette
Autor Adresse des Autors
Bildschirm freigeben TR_UnlockScreen()
Bildschirm sperren TR_LockScreen()
Breite einer Grafik ermitteln ImageWidth()
Button Button
CheckBox CheckBox
Copyright Copyright
CreateImage() CreateImage()
Cycle Cycle
Danksagungen Danksagungen
Datei-Requester ASL_RequestFile()
DeleteImage() DeleteImage()
DropBox DropBox
Eigenschaften von Applikationen Applikationen
Eigenschaften von Fenstern Projekte-Fenster
Eigenschaften von Menⁿs Menⁿs
Ein/Aus Schalter CheckBox
Einfache Requester TR_EasyRequest()
Eingaben erlauben TR_UnlockProject()
Eingaben verbieten TR_LockProject()
Einrahmen von Gruppen FrameBox
Einrahmen von Objekten FrameBox
Entstehungsgeschichte History
Fⁿllmuster fⁿr Fenster Fⁿllmuster fⁿr Fenster
Fⁿllmuster fⁿr Objekte Fⁿllmuster fⁿr Objekte
Farbauswahl Palette
Fehler ermitteln TR_GetLastError()
Fehlerbeschreibung ermitteln TR_GetErrorString()
Felder zur Mehrfachauswahl Cycle
Fenster ÷ffnen TR_OpenProject()
Fenster ⁿbernehmen TR_ObtainWindow()
Fenster als Requester TR_AutoRequest()
Fenster eines Projekts aktivieren ActivateProject()
Fenster eines Projekts nach hinten ProjectToBack()
Fenster eines Projekts nach vorne ProjectToFront()
Fenster freigeben TR_UnlockProject()
Fenster freigeben TR_ReleaseWindow()
Fenster schlie▀en TR_CloseProject()
Fenster sperren TR_LockProject()
Fenster-Fⁿllmuster Fⁿllmuster fⁿr Fenster
FlΣchen zum Fallenlassen von Icons DropBox
FlushTRX FlushTRX
Font-Requester ASL_RequestFont()
Fortschrittsanzeige Progress
FrameBox FrameBox
Funktion ActivateProject() ActivateProject()
Funktion ASL_RequestFile() ASL_RequestFile()
Funktion ASL_RequestFont() ASL_RequestFont()
Funktion CreateImage() CreateImage()
Funktion DeleteImage() DeleteImage()
Funktion ImageHeight() ImageHeight()
Funktion ImageWidth() ImageWidth()
Funktion ProjectToBack() ProjectToBack()
Funktion ProjectToFront() ProjectToFront()
Funktion TritonRexxVersion() TritonRexxVersion()
Funktion TritonVersion() TritonVersion()
Funktion TR_AutoRequest() TR_AutoRequest()
Funktion TR_CloseProject() TR_CloseProject()
Funktion TR_CreateApp() TR_CreateApp()
Funktion TR_DeleteApp() TR_DeleteApp()
Funktion TR_EasyRequest() TR_EasyRequest()
Funktion TR_FirstOccurance() TR_FirstOccurance()
Funktion TR_GetAttribute() TR_GetAttribute()
Funktion TR_GetErrorString() TR_GetErrorString()
Funktion TR_GetLastError() TR_GetLastError()
Funktion TR_GetMsg() TR_GetMsg()
Funktion TR_HandleMsg() TR_HandleMsg()
Funktion TR_LockProject() TR_LockProject()
Funktion TR_LockScreen() TR_LockScreen()
Funktion TR_NumOccurances() TR_NumOccurances()
Funktion TR_ObtainWindow() TR_ObtainWindow()
Funktion TR_OpenProject() TR_OpenProject()
Funktion TR_ReleaseWindow() TR_ReleaseWindow()
Funktion TR_ReplyMsg() TR_ReplyMsg()
Funktion TR_SendMessage() TR_SendMessage()
Funktion TR_SetAttribute() TR_SetAttribute()
Funktion TR_UnlockProject() TR_UnlockProject()
Funktion TR_UnlockScreen() TR_UnlockScreen()
Funktion TR_Wait() TR_Wait()
Funktionen Funktionen
Funktionen der Library Funktionen
Gemeinsamkeiten mit der 'triton.library'triton.library
Grafik l÷schen DeleteImage()
Grafik von Disk laden CreateImage()
Grafiken Image
Group Group
Gruppen Group
Gruppen einrahmen FrameBox
H÷he einer Grafik ermitteln ImageHeight()
History History
Image Image
Image l÷schen DeleteImage()
Image von Disk laden CreateImage()
ImageHeight() ImageHeight()
ImageWidth() ImageWidth()
Index Index
Informationen ⁿber 'Triton' Triton-Info
Installation Installation
Kn÷pfe Button
Kurze Vorstellung der Library ▄bersicht
Kurzhilfe QuickHelp
LeerrΣume zwischen Objekten Space
Line Line
Listen zur Darstellung und Auswahl Listview
Listview Listview
Mehrfachauswahl Cycle
Menⁿs Menⁿs
Nachricht beantworten TR_Wait()
Nachricht beantworten TR_ReplyMsg()
Nachricht empfangen TR_GetMsg()
Nachricht empfangen und beantworten TR_HandleMsg()
Nachrichten an Objekte TR_SendMessage()
OberflΣchen erstellen OberflΣchen erstellen
Objekt-Fⁿllmuster Fⁿllmuster fⁿr Objekte
Objekte einrahmen FrameBox
Objekte und Attribute Objekte und Attribute
Palette Palette
Progress Progress
ProjectToBack() ProjectToBack()
ProjectToFront() ProjectToFront()
Projekt ÷ffnen TR_OpenProject()
Projekt freigeben TR_UnlockProject()
Projekt schlie▀en TR_CloseProject()
Projekt sperren TR_LockProject()
Projekte Applikationen und Projekte
Projekte/Fenster Projekte-Fenster
QuickHelp QuickHelp
Rechliches Copyright
Schieberegler zum Scrollen durch ListenScroller
Schieberegler zur Einstellung von WertenSlider
Screen-Zeiger ermitteln TR_LockScreen()
Scroller Scroller
Slider Slider
Space Space
Stichwortverzeichnis Index
String String
Support-Mailbox Adresse des Autors
Systemvoraussetzungen Systemvoraussetzungen
Taglisten verwenden Taglisten verwenden
Text Text
Texte in verschiedenen DarstellungsartenText
Texteingabefelder String
Tips und Probleml÷sungen Tips und Probleml÷sungen
Trennlinien Line
Triton-Info Triton-Info
Triton-Version ermitteln TritonVersion()
triton.library triton.library
TritonRexx-Version ermitteln TritonRexxVersion()
TritonRexxVersion() TritonRexxVersion()
TritonVersion() TritonVersion()
TR_AutoRequest() TR_AutoRequest()
TR_CloseProject() TR_CloseProject()
TR_CreateApp() TR_CreateApp()
TR_DeleteApp() TR_DeleteApp()
TR_EasyRequest() TR_EasyRequest()
TR_FirstOccurance() TR_FirstOccurance()
TR_GetAttribute() TR_GetAttribute()
TR_GetErrorString() TR_GetErrorString()
TR_GetLastError() TR_GetLastError()
TR_GetMsg() TR_GetMsg()
TR_HandleMsg() TR_HandleMsg()
TR_LockProject() TR_LockProject()
TR_LockScreen() TR_LockScreen()
TR_NumOccurances() TR_NumOccurances()
TR_ObtainWindow() TR_ObtainWindow()
TR_OpenProject() TR_OpenProject()
TR_ReleaseWindow() TR_ReleaseWindow()
TR_ReplyMsg() TR_ReplyMsg()
TR_SendMessage() TR_SendMessage()
TR_SetAttribute() TR_SetAttribute()
TR_UnlockProject() TR_UnlockProject()
TR_UnlockScreen() TR_UnlockScreen()
TR_Wait() TR_Wait()
Was tun wenn... Tips und Probleml÷sungen
Window-Zeiger ermitteln TR_ObtainWindow()
Zeichen suchen TR_FirstOccurance()
Zeichen zΣhlen TR_NumOccurances()